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内 容 简 介 


JSF 是 一 种 用 于 构建 Java Web 应 用 的 标准 框架 ,也 是 Java EE 规范 中 Web 层 的 标准 技术 。 本 书 以 
JSF 2.0 为 背景 ,基于 JSF 2.0 推荐 的 Facelets 视图 技术 ,详细 介绍 JSF 的 各 项 核心 技术 及 其 应 用 。 本 书 同 
时 介绍 JPA 数据 库 访问 技术 , 它 是 Java EE 规范 中 持久 层 的 标准 技术 。 全 书 共 分 12 章 , 内 容 包 括 Web 应 
用 简介 .JSF 基础 、 受 管 bean 与 EL 表达 式 、 使 用 JSF 标记 、 页 面 导航 、 页 面 布局 与 数据 表格 ,转换 器 与 验证 
器 ,事件 处 理 、 资 源 包 与 国际 化 ,模板 与 复合 组 件 、Java DB 与 实体 类 、 实 体 管理 器 与 JPQL 等 。 

本 书 立 足 基 本 概念 方法 和 技术 ,注重 实践 与 应 用 环节 。 对 概念 .原理 和 方法 的 描述 力求 准确 、 严 谨 ， 
对 示例 力求 代码 规范 、 面 向 实际 应 用 。 本 书 可 作为 普通 高 等 学 校 计算 机 及 相关 专业 的 教材 ,也 可 作为 Web 
应 用 开发 者 学 习 和 使 用 JSF 技术 的 参考 书 。 
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出 版 说 明 


信息 时 代 早 已 显现 其 诱 人 魅力 ,当前 几乎 每 个 人 随身 都 携 有 多 个 媒体 、 信 息 和 通信 设 
备 ,享受 其 带 来 的 快乐 和 便捷 。 

我 国 高 等 教育 早已 进入 大 众 化 教育 时 代 , 而 且 计 算 机 技术 发 展 很 快 ,知识 更 新 速度 也 在 
快速 增长 ,社会 对 计算 机 专业 学 生 的 专业 能 力 要 求 也 在 不 断 翻 新 。 这 就 使 得 我 国 目前 的 计 
算 机 教育 面临 严峻 挑战 。 我 们 必须 更 新 教育 观念 一 一 弱化 知识 培养 目的 ,强化 对 学 生 兴 趣 
的 培养 ,加 强 培 养 学 生理 论 学 习 , 快 速 学 习 的 能 力 ,强调 培养 学 生 的 实践 能 力 .动手 能 力 \ 研 
究 能 力 和 创新 能 力 。 

教育 观念 的 更 新 ,必然 导致 教材 的 更 新 。 一 流 的 计算 机 人 才 需 要 一 流 的 名 师 指 导 ,而 一 
流 的 名 师 需 要 精品 教材 的 辅助 ,而 精品 教材 也 将 有 助 于 催生 更 多 一 流 名 师 。 名 师 们 在 长 期 
的 一 线 教 学 改革 实践 中 ,总结 出 了 一 整套 面向 学 生 的 独特 的 教 法 、 经 验 、 教 学 内 容 等 。 本 套 
丛书 的 目的 就 是 推广 他 们 的 经 验 ,并 促使 广大 教育 工作 者 进一步 更 新 教育 观念 。 

在 教育 部 相关 教学 指导 委员 会 专家 的 帮助 和 指导 下 ,在 各 大 学 计算 机 院 系 领导 的 协助 
下 ,清华 大 学 出 版 社 规 划 并 出 版 了 本 系列 教材 ,以 满足 计算 机 课程 群 建设 和 课程 教学 的 需 


本 系列 教材 行文 注重 趣味 性 ,立足 课程 改革 和 教材 创新 , 广 纳 全 国 高 校 计算 机 专业 一 线 
优秀 名 师 参与 ,从 中 精 选 出 佳作 予以 出 版 。 

本 系列 教材 具有 以 下 特点 。 

1. 有 的 放 矢 

针对 计算 机 专业 学 生 并 站 在 计算 机 课程 群 建设 技术 市 场 需求 .创新 人 才 培 养 的 高 度 ， 
规划 相关 课程 群 内 各 门 课程 的 教学 关系 ,以 达到 教学 内 容 互 相 衔接 、 补 充 、 相 互 贯穿 和 相互 
促进 的 目的 。 各 门 课程 功能 定位 明确 ,并 去 掉 课 程 中 相互 重复 的 部 分 ,使 学 生 既 能 够 掌握 这 
些 课程 的 实质 部 分 ,又 能 节约 一 些 课时 ,为 开设 社会 需求 的 新 技术 课程 准备 条 件 。 

2. 内 容 趣味 性 强 

按照 教学 需求 组 织 教学 材料 ,注重 教学 内 容 的 趣味 性 ,在 培养 学 习 观 念 、 学 习 兴 趣 的 同 
时 ,注重 创新 教育 ,加 强 “ 创 新 思维 ”“ 创 新 能 力 ” 的 培养 ,训练 ;强调 实践 ,案例 选 题 注重 实际 
和 兴趣 度 , 大 部 分 课程 各 模块 的 内 容 分 为 基本 、 加 深 和 拓宽 内 容 3 个 层次 。 

3. 名 师 精 品 多 

广 罗 名 师 参 与 ,对 于 名 师 精 品 ,予以 重点 扶持 , 教 辅 . 教 参 .教案 .PPT、 实 验 大 纲 和 实验 
指导 等 配套 齐全 ,资源 丰富 。 同 一 门 课程 .不 同名 师 分 出 多 个 版 本 ,方便 选用 。 

4. 一 线 教师 亲 力 

专家 咨询 指导 ,一 线 教师 亲 力 ;内 容 组 织 以 教学 需求 为 线索 ;注重 理论 知识 学 习 , 注 重 学 

小 


习 能 力 培养 ,强调 案例 分 析 ,注重 工程 技术 能 力 银 炼 。 

经 济 要 发 展 ,国力 要 增强 ,教育 必须 先行 。 教 育 要 靠 教师 和 教材 ,因此 建立 一 支 高 水 平 
的 教材 编写 队伍 是 社会 发 展 的 需要 , 特 希望 有 志 于 教材 建设 的 教师 能 够 加 入 到 本 团队 。 通 
过 本 系列 教材 的 辐射 ,培养 一 批 热 心 为 读者 奉献 的 编写 教师 团队 。 


清华 大 学 出 版 社 
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JSF(JavaServer Faces) 是 一 种 用 于 构建 Java Web 应 用 的 软件 框架 。 它 提供 以 组 件 为 
中 心事 件 驱 动 为 基础 的 用 户 界面 构建 方法 ,可 以 简化 和 减轻 Java Web 应 用 的 开发 难度 和 
开发 强度 。 自 JSF 1.2 随 Java EE 5 于 2006 年 发 布 后 ,该 技术 受到 了 业界 的 广泛 响应 和 支 
持 。 在 JavaEE 5 中 ,JSF 成 为 Web 层 的 三 大 主要 技术 (ServletJSP 和 JSF) 之 一 。 

2009 年 6 月 ,JSF 2.0 随 Java EE6 一 起 发 布 。 在 Java EE 6 中 ,JSF 已 取代 JSP 成 为 
Web 层 的 主要 技术 。 与 JSF 1. 2 相 比 ,JSF 2.0 不仅 支持 基于 JSP 的 视图 技术 ,也 支持 
Facelets 视图 技术 ,而且 将 Facelets 列 为 首选 的 视图 语言 。David Geary 和 Cay Horstmann 
合 著 的 《Core JavaServer Faces( 第 3 版 )) 已 经 用 Facelets 视图 技术 取代 基于 JSP 的 视图 技 
术 进 行 更 新 ,并 于 2010 年 5 月 出 版 。 

本 书 以 JSF 2.0 为 背景 ,基于 JSF 2.0 推荐 的 Facelets 视图 技术 ,详细 介绍 JSF 的 各 项 
核心 技术 及 其 应 用 。 本 书面 向 的 读者 要 求 具有 一 定 的 Java 编程 基础 ,对 HTML 语言 最 好 
有 一 定 的 了 解 。 本 书 可 以 用 作 普 通 高 等 学 校 相关 课程 的 教学 用 书 , 也 可 供 广 大 Web 应 用 开 
发 人 员 学 习 和 参考 之 用 。 

JSF 技术 用 于 构建 Web 应 用 ,本 书 首先 在 第 1 章 对 Web 及 Web 应 用 的 起 源 、 概 念 、 原 
理 和 基本 开发 过 程 进行 简单 介绍 ,然后 在 第 2 章 对 JSF 的 作用 、 特 点 及 相关 概念 和 原理 进行 
了 总 体 介绍 。 第 3 章 至 第 10 章 则 分 别 对 JSF 的 各 单项 技术 及 其 应 用 进行 详细 介绍 。 大 多 
数 Web 应 用 都 是 以 数据 库 为 中 心 的 ,本 书 最 后 两 章 介 绍 Java 数据 库 访问 技术 JPA 及 其 在 
Web 应 用 开发 中 的 应 用 ,包括 实体 类 的 定义 ,实体 管理 以 及 Java 持久 性 查询 语言 (JPQL)。 

全 书 立 足 基本 理论 和 方法 ,注重 实践 与 应 用 环节 。 对 基本 原理 .技术 和 方法 的 介绍 力求 
概念 明确 .结构 清晰 . 逮 辑 严谨 。 以 实际 应 用 为 出 发 点 ,本章 所 介绍 内 容 为 着 眼 点 ,精心 设计 
各 章 的 应 用 示例 。 以 MVC 架构 为 指导 思想 ,介绍 各 应 用 示例 的 开发 。 各 应 用 示例 一 般 都 
包括 模型 . 受 管 bean 和 JSF 页 面 几 部 分 。 

本 书 还 介绍 了 一 个 较为 完整 的 Web 应 用 (论坛 ) 的 开发 ,其 功能 包括 登录 注册、 浏览 主 
题 ,发表 主题 .查看 回复 .回复 主题 等 。 该 应 用 开发 的 介绍 没有 独立 成 章 ,而 是 随 各 章 知 识 点 
的 逐步 介绍 和 推进 ,分 步 又、 分 层次 地 展开 。 

本 书 采 用 JDK 自身 携带 的 Java DB 为 应 用 所 需 的 数据 库 管 理 系统 ,Oracle 公司 官方 支 
持 的 NetBeans IDE 为 应 用 开发 平台 。 

本 书 提供 相关 的 教学 资源 ,包括 教学 课件 以 及 所 有 应 用 示例 的 源 代码 。 欢 迎 读者 从 清 
华 大 学 出 版 社 网 站 http://www. tup. tsinghua. edu. cn 本 书 相 应 页 面 下 载 和 使 用 。 

由 于 作者 学 识 水 平 有 限 , 本 书 难免 有 错误 和 不 受 之 处 , 敬 请 广大 读者 批评 指正 。 如 果 读 
者 有 好 的 建议 或 要 求 ,请 与 作者 联系 ,电子 邮箱 地 址 是 loubuye@163. com。 


娄 不 夜 
2013 年 2 月 
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第 1 章 Web 应 用 简介 


本 章 主题 : 

。 万 维 网 (URL、HTTP、HTML) 
。 Web 应 用 的 组 成 、 目 录 结 构 

。 Web 容器 ,上下文 

。 Web 应 用 的 生命 周期 

。 NetBeans IDE 操作 基础 

。 Web 应 用 开发 示例 


万 维 网 是 Web 应 用 的 载体 , Web 应 用 在 很 多 方面 有 别 于 传统 的 应 用 软件 。 本 章 首先 
介绍 万 维 网 的 基础 知识 ,然后 介绍 Web 应 用 的 一 些 基本 概念 ,作为 进一步 学 习 JSF 应 用 的 
基础 。 本 章 最 后 介绍 了 NetBeans IDE 的 一 些 基 本 操作 ,并 通过 一 个 简单 的 例子 ,演示 了 
Web 应 用 的 组 成 及 其 开发 过 程 中 涉及 的 一 些 操作 。 


1.1 Web 基础 


Web 是 World Wide Web 的 简称 ,又 称 WWW、W3 ,中文 译名 为 “万 维 网 ”, 是 目前 因 特 
网 (Internet) 上 最 主要 的 信息 服务 形式 。 万 维 网 由 许多 互相 链接 的 HTML 文档 等 信息 资 
源 组 成 ,这 些 信息 资源 又 由 遍布 在 互联 网 上 的 称 为 Web 服务 器 的 计算 机 管理 ,用 户 则 可 以 
通过 客户 端 浏览 器 进行 浏览 。 万 维 网 的 基本 结构 如 图 1-1 所 示 。 


输入 URL HTTP 请 求 
Web 服务 器 


二 
显示 HTML HTTP 响应 


图 1-1 Web 基本 结构 


万 维 网 技术 最 早 由 欧洲 核子 研究 中 心 的 带 姆 . 伯 纳 斯 一 李 (Tim Berners-Lee) 于 1990 
年 提出 ,其 最 初 的 目的 是 为 了 解决 各 个 研究 项 目 组 和 科研 人 员 之 间 的 信息 交流 和 共享 问题 ， 
避免 因 信息 交 流 不 畅 和 丢失 而 造成 一 些 研 究 工作 的 重复 。 万 维 网 技术 的 核心 包括 统一 资源 
定位 符 (URL) 、 超 文本 传输 协议 (HTTP) 和 超 文本 标记 语言 (HTML)。 


1.1.1 URL 


统一 资源 定位 符 (Uniform Resource Locator, URL), 也 称 为 网 页 地 址 ,或 简称 为 网 址 ， 
是 定位 因特网 上 资源 的 标准 地 址 。URL 的 语法 格式 


< 协议 类 型 > :/ /< 服务 器 名 > [:< 端 口号 >] /< 路 径 > [?< 查 询 串 >] 


其 中 参数 说 明 如 下 。 

(1) 协议 类 型 : 指定 传输 信息 所 采用 的 网 络 协议 。 最 基本 的 协议 是 HTTP, 有 时 也 可 
能 会 用 到 其 他 协议 ,如 HTTPS、FTP、MAILTO 等 。 

(2) 服务 器 名 : 指定 资源 所 在 的 Web 服务 器 的 域名 ,通常 以 . com.. net\. org、. gov、. cn 
等 后 级 结尾 。 有 时 也 可 用 IP(Internet Protocal) 地 址 来 指定 Web 服务 器 。 

(3) 端口 号 : 端口 又 指 协议 端口 ,是 特定 应 用 或 进程 作为 通信 端点 的 软件 结构 。 端 口 
号 是 一 个 无 符号 整数 ,范围 是 0 一 65 535。 对 于 Web 服务 器 提供 的 HTTP 通信 服务 ,默认 
端口 号 是 80 ,此 时 在 URL 中 经 常 省 略 端口 号 。 

(4) 路 径 : 用 于 指定 资源 ,通常 包括 资源 在 Web 服务 器 中 的 位 置信 息 及 名 称 。 路 径 一 
般 是 区 分 大 小 写 的 。 

(5) 查询 串 : 是 一 个 经 过 编码 的 、 由 一 组 名 称 / 值 对 (用 & 分 隔 ) 组 成 的 字符 串 , 表 示 在 
HTTP 请 求 中 发 送 的 数据 ,也 称 为 请 求 参 数 。 例 如 : id 一 100&p 一 2。 


1.1.2 HTTP 


超 文 本 传输 协议 (HyperText Transfer Protocal, HTTP) 是 一 种 建立 在 TCP 
(Transmission Control Protocal) 协 议 之 上 的 属于 应 用 层 的 网 络 协议 ,是 万 维 网 上 数据 通信 
的 基础 ,适用 于 分 布 式 , 协 作 式 的 超 媒体 信息 系统 。 

1. 请 求 一 响应 过 程 

HTTP 是 一 种 无 连接 、 无 状态 的 协议 。 无 连接 并 不 是 指 不 需要 连接 ,而 是 指 每 次 连接 
仅 限于 一 次 请 求 一 响应 过 程 。 下 一 次 的 请 求 一 响应 过 程 需 要 重新 进行 连接 。 无 状态 是 指 协 
议 没有 记忆 约定 ,前 后 两 次 请 求 一 响应 过 程 是 相互 独立 的 ,协议 本 身 并 不 会 依据 上 一 次 请 
求 一 响应 的 状态 来 处 理 下 一 次 的 请 求 一 响应 。 

基于 HTTP 协议 的 请 求 一 响应 过 程 分 4 个 步 又 。 

(1) 建立 连接 。 通 过 域名 (或 IP 地 址 ) ,客户 端 连接 到 服务 器 。 

(2) 发 送 请 求 。 建 立 连接 后 ,客户 端 把 请 求 信息 送 到 服务 器 的 端口 上 ,完成 请 求 动作 。 

(3) 发 送 响应 。 服 务 器 处 理 请 求 ,然后 向 客户 端 发 送 响应 信息 。 

(4) 关闭 连接 。 当 响应 发 送 完毕 ,服务 器 关闭 连接 。 客 户 端 也 可 以 在 完整 接收 响应 之 
前 ,终止 数据 传输 ,关闭 连接 。 

2. 请 求 信息 

客户 端 向 服务 器 发 送 的 请 求 信息 有 较为 固定 的 内 容 组 成 和 格式 ,由 请 求 行 .请 求 头 和 请 
求 体 等 组 成 。 图 1-2 是 请 求 信息 的 一 个 示例 。 

请 求 行 : POST /hello/hello.html HTTP/1.1 

请 求 头 : Host: localhost:8080 
Accept-Language: zh-cn,zh 
Content-Type: application/x-www-form-urlencoded 
Content-Length: 30 


空 行 : 
请 求 体 : username=zhang&password=123456 
图 1-2 ”请求 信息 示例 


首先 是 请 求 行 , 它 包含 方法 .请求 URI 和 协议 版 本 号 三 项 内 容 ,相互 之 间 用 空格 分 隔 。 
< 方法 >< 请 求 URI>< 协 议 版 本 号 > 


方法 指定 本 次 请 求 的 性 质 , 即 本 次 请 求 要 对 指定 的 资源 做 何 种 操作 ,如 查询 、` 添 加 、 删 
除 、 更 新 等 。 目 前 ,大 多 数 浏览 器 仅 支持 GET 和 POST 两 种 方法 。 一 般 来 说 ,查询 操作 应 
该 用 GET 方法 ,其 他 操作 则 可 用 POST 方法 。 通 常 ,采用 GET 方法 的 请 求 也 称 为 GET 请 
求 ,采用 POST 方法 的 请 求 也 称 为 POST 请 求 。 

请 求 URI(Uniform Resource Identifier) 是 指 URL 中 端口 号 后 面 的 内 容 , 即 不 包括 其 
中 的 协议 类 型 .服务 器 名 和 端口 号 ,用 于 标识 资源 。 这 时 ,有 关 服 务 器 的 信息 应 该 在 请 求 头 
Host 域 中 指定 。 

请 求 行 的 后 面 是 请 求 头 。 请 求 头 包 含 一 些 域 ,每 个 域 占 一 行 ,由 域名 和 域 值 组 成 ,两 者 
之 间 用 冒号 分 隔 。 有 些 域 可 能 有 多 个 值 。 请 求 头 用 于 指定 本 次 请 求 以 及 客户 端的 一 些 附加 
信息 

请 求 头 的 后 面 是 一 空 行 ( 仅 包 含 回 车 换行 符 ) ,该 空 行 表示 请 求 头 的 结束 。 

请 求 信息 的 最 后 是 可 选 的 请 求 体 。 请求 体 的 内 容 依据 请 求 方法 的 不 同 而 不 同 。 
POST 请 求 ,请 求 体 一 般 仅 包含 一 些 请 求 参数 。 对 GET 请 求 ,请 求 体 往往 是 空 的 ， 
参数 包含 在 请 求 行 的 请 求 URI 中 。 

3， 响应 信息 

与 请 求 信息 一 样 ,服务 器 向 客户 端 发 送 的 响应 信息 也 有 固定 的 内 容 组 成 和 格式 。 响 应 
信息 由 状态 行 、 响 应 头 和 响应 体 等 组 成 ,图 1-3 是 响应 信息 的 一 个 示例 。 

状态 行 : HTTP/1.1 200 OK 

响应 头 : Server: GlassFish Server Open Source Edition 
3.0.1 
Content-Type: text/html 


Content-Length: 232 
Date: Mon, 20 Feb 2012 09:55:09 GMT 


图 1-3 响应 信息 示例 


响应 信息 的 第 一 行 是 状态 行 , 它 包含 协议 版 本 号 ,状态 码 及 相应 的 状态 描述 信息 ,相互 
之 问 用 空格 分 隔 。 即 


< 协议 版 本 号 >< 状 态 码 >< 状 态 描述 > 


状态 行 中 的 状态 码 由 3 位 数字 组 成 ,其 中 第 一 位 数字 是 对 响应 状态 的 一 个 分 类 。 下 面 
是 5 类 状态 码 的 一 个 总 体 描述 。 

(1) 1xx: 消息 ,请 求 已 被 接收 ,继续 处 理 。 

(2) 2xx: 成 功 ,请 求 已 成 功 被 服务 器 接收 理解 接受 并 处 理 。 

(3) 3xx: 重 定向 ,客户 端 需 要 后 续 操作 才能 完成 这 一 请 求 。 

(4) 4xx: 客户 错误 ,请 求 含 有 词法 错误 或 者 无 法 被 执行 。 

(5) 5xx: 服务 器 错误 ,服务 器 在 处 理 某 个 请 求 时 发 生 错 误 。 


状态 行 后 面 是 响应 头 。 与 请 求 头 类 似 , 响 应 头 也 由 一 些 域 组 成 ,用 于 指定 本 次 响应 以 及 
服务 器 的 一 些 附加 信息 。 

响应 头 的 后 面 是 一 空 行 ( 仅 包含 回 车 换行 符 ) ,该 空 行 表示 响应 头 的 结束 。 

响应 信息 的 最 后 是 响应 体 , 是 响应 内 容 本 身 , 如 客户 请 求 的 HTML 文档 内 容 。 


LL:3. ‘HIME 


超 文 本 标记 语言 (HyperText Markup Language, HTML) 是 一 种 构建 Web 页 的 主要 标 
记 语 言 。 

HTML 文档 是 一 种 文本 文件 ,由 要 显示 的 内 容 数 据 和 HTML 标记 组 成 。HTML 标记 
用 于 指定 文档 的 结构 .内容 的 显 式 格式 。 每 个 HTML 标记 由 一 个 小 于 号 、 标 记名 称 、 属 性 
和 一 个 大 于 号 构成 。 一 般 情况 下 ,标记 是 成 对 出 现 的 , 即 以 起 始 标记 开始 .以 结束 标记 结尾 ， 
两 者 之 间 的 内 容 是 标记 的 作用 范围 。 

HTML 允许 在 Web 页 中 舱 入 图 像 和 对 象 ,也 可 以 包含 用 于 接收 用 户 数据 的 表单 。 
HTML 允许 在 页 面 中 嵌入 脚本 代码 (如 JavaScript) ,来 影响 页 面 的 行为 。HTML 支持 CSS 
技术 ,以 便 定义 页 面 内 容 的 外 观 和 布局 。 

Web 浏览 器 的 作用 是 接收 HTML 文档 .解析 HTML 标记 ,产生 人 们 习惯 阅读 和 浏览 
的 Web 页 面 。 


1.2 理解 Web 应 用 


早期 的 万 维 网 主要 由 一 些 HTML 文档 等 静态 资源 组 成 。 随 着 应 用 的 需要 ,各 种 动态 
网 页 技术 相继 出 现 , 如 ASP、Servlet、JSP 等 。 动 态 网 页 的 本 质 是 一 段 程序 代码 , 它 可 以 处 理 
客户 请 求 .并 动态 产生 响应 。 这 样 ,万 维 网 上 不 仅 包含 可 供 浏览 的 数据 资源 ,也 包含 可 进行 
数据 处 理 的 软件 资源 , Web 应 用 的 概念 也 因此 产生 。 


1.2.1 什么 是 Web 应 用 


Web 应 用 是 指 通 过 Web 访问 的 应 用 软件 。 一 个 Java Web 应 用 可 以 由 以 下 元 素 组 成 : 

。 Web 静态 资源 文档 (HTML 页 面 、 图 像 等 ); 

。 applet(Java 小 应 用 程序 ); 

。 Web 组 件 (Servlet、JSP 页 面 JSF 页 面 ); 

。 JavaBean 以 及 实用 类 ，; 

。 部 署 描述 符 等 配置 文件 。 

Web 静态 资源 和 applet 不 在 服务 器 端 处 理 .而 是 下 载 到 客户 端 ,由 客户 端 解析 、 显 示 或 
运行 。Web 组 件 又 称 动态 页 面 , 当 被 客户 端 请 求 时 ,在 服务 器 端 被 解析 、 处 理 和 运行 ,并 动 
态 产 生 响 应 。 

JavaBean 以 及 实用 类 既 可 以 被 applet 调用 ,也 可 以 被 Web 组 件 调 用 。 如 果 是 被 applet 
调用 ,将 被 下 载 到 客户 端 运行 。 如 果 是 被 Web 组 件 调用 , 则 在 服务 器 端 运行 。 

一 个 Web 应 用 除了 上 述 元 素 外 ,往往 会 包含 一 个 部 署 描 述 符 (Deployment Descriptor， 
DD) 和 其 他 的 一 些 配置 文件 。 部 署 描述 符 等 配置 文件 是 一 些 XML 文档 ,使 用 特定 的 元 素 
EE 


向 服务 器 描述 该 Web 应 用 的 部 署 要 求 、 所 需 的 服务 等 信息 或 参数 。 其 中 部 署 描述 符 具 有 特 
定 的 文件 名 , 即 web. xml。 

许多 配置 信息 不 仅 可 以 在 部 署 描述 符 等 配置 文件 中 指定 ,也 可 以 通过 Java 标注 直接 出 
现在 Java 类 中 。 

Web 应 用 由 一 些 不 同性 质 和 作用 的 元 素 组 成 ,这 些 元 素 被 要 求 按 特定 的 结构 组 织 。 首 
先 ,所 有 的 元 素 文件 存储 在 一 个 被 称 为 Web 应 用 文档 根 的 目录 下 ,如 图 1-4 所 示 。 


文档 根 目录 
| 
WEB-INF 
| | 
lib Gi Web 页 
web.xml 等 | | 
库 (jar) .Class 


图 1-4 Web 应 用 日 录 结构 


在 这 里 ,文档 根 目录 及 其 非 WEB-INF 子 目录 用 于 存放 那些 被 认为 对 客户 端 可 见 .能 被 
客户 端 直接 访问 的 文件 ,包括 静态 文档 、JSP 页 JSF 页 ,applet 及 其 相关 类 。 

文档 根 目 录 下 有 一 个 重要 的 子 目 录 WEB-INF, 用 于 存放 那些 只 对 Web 容器 和 Web 应 
用 本 身 可 见 的 文件 。 其 中 ,classes 子 目 录 通 常 存放 那些 属于 Web 应 用 自身 的 、 和 有 丰 间 册 
运行 的 Java 类 文件 ,如 servlet 类 、JavaBean 类 及 其 他 相关 的 实用 类 。 这 些 Java 类 可 以 被 组 
织 在 不 同 的 包 里 ,所 以 classes 子 目录 下 可 以 有 相应 的 子 目 录 。lib 子 目录 存放 该 Web 应 用 
所 需 的 一 些 Java 类 库 , 即 Java 档案 文件 (Java ARchive file) ,也 称 JAR 文件 。JAR 文件 是 
一 种 包含 一 组 Java 类 的 压缩 文件 ,扩展 名 为 . jar。 

部 署 描述 符 等 配置 文件 一 般 直 接 存放 在 WEB-INF 子 目 录 下 。 


1.2.2 Web 容器 


与 Web 静态 资源 由 客户 端 解析 、 显 示 或 运行 不 同 , Web 组 件 在 服务 器 端 被 解析 、 处 理 
和 运行 ,并 动态 产生 响应 。Web 组 件 不 仅 需 要 在 服务 器 端 被 进行 额外 的 处 理 和 管理 ,而 且 
往往 需要 调用 诸如 安全 性 、 事 务 处 理 等 通用 性 的 基础 服务 。 传 统 的 Web 服务 器 并 不 具有 这 
些 功 能 ,由 此 一 种 被 称 为 Web 容器 的 新 型 软件 部 件 就 出 现 了 。 

Web 容器 是 Web 组 件 的 运行 平台 ,提供 诸如 请 求 派发 .生命 周期 管理 、 安 全 性 、 并 发 
性 ,事务 处 理 、 部 署 等 服务 。Web 组 件 可 以 通过 部 署 描述 符 等 配置 文件 或 Java 标注 配置 这 
些 服务 ,或 者 利用 相应 的 API 调用 这 些 服务 。 

Web 容器 的 引入 降低 了 Web 应 用 的 开发 难度 、 提 高 了 Web 应 用 的 开发 效率 和 可 移植 
性 。 它 使 开发 人 员 可 以 将 注意 力 专 注 于 与 特定 领域 相关 的 应 用 问题 和 数据 处 理 逻 辑 ,而 不 
必 纠 缠 于 通用 而 又 复杂 的 基础 服务 功能 。 

Web 组 件 与 静态 资源 的 上 述 差异 ,也 反映 在 其 请 求 与 响应 过 程 中 。 图 1-5 是 引入 Web 

5 。 


组 件 和 Web 容器 后 的 Web 结构 示意 图 。 
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图 1-5 Web 容器 及 Web 组件 的 请 求 与 响应 


如 果 客 户 请 求 的 是 一 个 静态 资源 , Web 服务 器 可 以 直接 读 取 该 资源 并 产生 HTTP 响 
应 。 如 果 请 求 的 是 一 个 Web 组 件 , Web 服务 器 则 将 请 求 委托 给 Web 容器 处 理 。Web 容器 
通过 Web 组 件 处 理 请 求 并 产生 响应 内 容 , 最 后 由 Web 服务 器 向 客户 端 发 送 HTTP 响应 。 

以 servlet 组 件 为 例 , 如 果 该 servlet 是 第 一 次 被 客户 请 求 ,Web 容器 将 首先 装载 该 组 件 
相应 的 类 文件 ,然后 实例 化 并 初始 化 组 件 的 实例 对 象 ,最 后 调用 实例 对 象 相应 的 服务 方法 产 
生 响 应 内 容 。 在 此 期 间 创建 的 组 件 实例 对 象 将 被 Web 容器 管理 。 如 果 该 servlet 组 件 被 再 
次 请 求 , Web 容器 将 直接 调用 已 存在 的 组 件 实例 对 象 相应 的 服务 方法 ,产生 响应 。 


1.2.3 ”Web 应 用 生命 周期 


Web 应 用 有 别 于 传统 的 软件 ,一 是 它 由 各 种 具有 不 同性 质 和 作用 的 元 素 组 成 ,而 不 是 
单纯 地 由 程序 模块 (如 Java 类 ) 组 成 ,二 是 它 会 通过 部 署 描述 符 等 配置 文件 或 Java 标注 等 
向 Web 服务 器 提出 运行 时 的 一 些 要 求 或 所 需要 的 一 些 服 务 。 因 此 , Web 应 用 的 开发 过 程 
与 传统 软件 的 开发 过 程 也 会 有 所 不 同 。 下 面 是 创建 ,部 署 和 运行 一 个 Web 应 用 的 简要 

(1) 开发 静态 资源 、applet、Web 组 件 、JavaBean 类 。 

(2) 定义 部 署 描 述 符 及 其 他 的 配置 文件 (可 选 ) 。 

(3) 编译 applet servlet JavaBean 类 及 其 他 实用 类 ,并 按 特定 的 结构 组 织 各 种 文件 、 构 
建 Web 应 用 。 

(4) 打包 产生 Web 档案 文件 (可 选 ) 。 

(5) 将 Web 应 用 部 署 到 Web 服务 器 中 。 

(6) 通过 Web 浏览 器 访问 Web 应 用 。 

一 个 Web 应 用 的 部 署 描述 符 及 其 他 配置 文件 可 以 根据 需要 定义 ,可 以 有 也 可 以 没有 。 
但 通常 都 会 有 部 署 描述 文件 及 若干 配置 文件 。 

一 个 Web 应 用 可 以 直接 部 署 到 Web 服务 器 中 ,也 可 以 打包 成 Web 档案 文件 后 再 部 署 
到 Web 服务 器 中 。Web 档案 文件 (Web ARchive file) 又 称 WAR 文件 ,是 一 种 包含 Web 应 
用 的 压缩 文件 ,扩展 名 为 . war。WAR 文件 和 JAR 文件 的 压缩 机 制 完 全 相同 ,两 者 的 区 别 
主要 是 : 一 是 文件 扩展 名 不 同 , 二 是 包含 的 内 容 不 同 。 

一 个 Web 服务 器 可 以 部 署 多 个 Web 应 用 ,每 个 Web 应 用 被 部 署 在 一 个 所 谓 的 上 下 文 
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中 。 每 个 上 下 文 有 一 个 上 下 文 路 径 ( 以 /开头 \ 以 字符 串 结尾 ) ,客户 端 应 通过 上 下 文 路 径 访 
问 相 应 Web 应 用 中 的 资源 。 


1.3 ”集成 开发 环境 NetBeans IDE 


NetBeans IDE 是 一 种 免费 、 开 源 的 集成 开发 环境 。 它 支持 开发 者 利用 Java、C/C++、 
PHP、JavaScript 和 Groovy 等 语言 和 技术 开发 专业 的 桌面 应 用 ,企业 级 应 用 、Web 应 用 和 移 
动 应 用 等 。 

NetBeans IDE 可 以 从 NetBeans 的 官方 网 站 (http://netbeans. org/) 上 下 载 。 本 书 使 
用 的 NetBeans IDE 是 简体 中 文 . Windows 平台 的 NetBeans IDE 6. 9. 1 完整 版 ,下 载 的 安装 
程序 文件 是 netbeans-6. 9. 1-ml-java-windows. exe。 

安装 和 运行 NetBeans IDE 之 前 ,需要 先 安装 JDK。 通 常 ,不 同 版 本 的 NetBeans IDE 
需要 相应 版 本 的 JDK。 比 如 ,NetBeans IDE 6.9.1 需要 JDK 6 Update 13 或 之 后 的 版 本 。 

安装 好 JDK 后 ,就 可 以 安装 NetBeans IDE 了 。 要 安装 NetBeans IDE, 只 需 双击 运行 
安装 程序 文件 ,然后 根据 安装 向 导 的 提示 进行 操作 即 可 。 默 认 情况 下 ,安装 程序 会 安装 除 
Apache Tomcat 之 外 的 所 有 部 件 和 功能 。 若 有 需要 ,可 以 在 安装 欢迎 页 面 中 单 击 “ 定 制 ? 按 
钮 ,然后 定制 需要 安装 的 部 件 和 功能 。 在 安装 过 程 中 ,向 导 会 引导 选择 合适 的 JDK ,在 桌面 
和 开始 菜单 中 添加 快捷 方式 (可 选 ) 等 。 

安装 好 NetBeans IDE 后 ,就 可 以 开始 工作 了 。 在 利用 NetBeans IDE 开发 第 一 个 JSF 
应 用 之 前 ,需要 先 熟悉 一 下 NetBeans IDE 界面 的 基本 组 成 。 初 始 启动 NetBeans IDE 时 ,其 
界面 主要 包含 一 个 显示 于 编辑 窗 格 内 的 “起 始 页 ”。 大 多 数 情况 下 ,NetBeans IDE 界面 大 致 
如 图 1-6 所 示 。 
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图 1-6 NetBeans IDE 界面 


在 NetBeans IDE 界面 中 , 除 菜单 栏 和 工具 栏 外 ,主要 由 一 些 位 置 和 大 小 可 变 的 窗 格 组 
成 。 其 中 ,编辑 器 窗 格 通常 位 于 界面 的 中 间 ,用 于 显示 和 编辑 文档 内 容 。 每 个 在 编辑 器 窗 格 
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打开 的 文档 都 有 一 个 标签 ,通过 这 些 标签 可 以 在 不 同文 档 间 快速 切换 。 其 他 窗 格 可 以 包含 
一 个 或 多 个 不 同 用 途 的 窗口 ,每 个 窗口 在 窗 格 中 也 都 有 一 个 标签 。 下 面 是 一 些 常用 的 窗口 。 

1.“ 项 目 ” 窗 口 

“项 目 ?窗口 是 项 目 源 的 主人 口 点 ,显示 项 目 重要 内 容 的 逻辑 视图 。 项 目 可 以 是 Java 应 
用 程序 、EJB 模块 、Web 应 用 程序 等 。 

2.“ 文 件 ” 窗 口 

“文件 ”窗口 用 于 显示 基于 目录 的 项 目 视 图 ,其 中 包括 “项 目 ” 窗 口中 未 显示 的 任何 文件 
和 文件 夹 。 

3.“ 服 务 ” 窗 口 

“服务 ”窗口 显示 运行 时 资源 的 一 个 逻辑 视图 ,如 服务 器 、 数 据 库 等 。 在 这 个 窗口 ,可 以 
对 这 些 运行 时 资源 进行 一 些 相 关 操 作 , 如 添加 一 个 服务 器 ,启动 或 关闭 服务 器 ,创建 数据 库 ， 
对 数据 库 执行 SQL 操作 等 。 

4.“ 导 航 ” 窗 口 

“导航 ”窗口 提供 了 当前 选 定 文件 的 简洁 视图 ,并 且 可 以 简化 文件 不 同 部 分 之 间 的 导航 。 
在 “导航 "窗口 中 双击 某 个 元 素 ,编辑 器 窗口 中 的 光标 就 会 移 至 该 元 素 。 

5.“ 输 出 "窗口 

“输出 ”窗口 是 一 个 多 标签 窗口 ,可 以 显示 来 自 IDE 的 各 类 消息 。 如 对 项 目 编译 .打包 
时 产生 的 消息 ,启动 服务 器 、 部 署 项 目 时 产生 的 消息 ,项 目 运 行 时 产生 的 标准 输出 等 。 

对 各 种 窗口 ,用 户 可 以 根据 需要 打开 或 关闭 。 要 打开 一 个 窗口 ,可 以 从 “窗口 "菜单 中 选 
择 相 应 的 菜单 项 或 子 菜单 项 。 要 关闭 一 个 窗口 .只 需 单 击 该 窗口 标签 右 端 的 “关闭 窗口 “ 按 
钮 。 某 些 窗 口 会 在 执行 相关 任务 时 自动 出 现 。 

通过 鼠标 拖 放 窗口 标签 ,可 以 移动 窗口 。 窗 口 可 以 在 同一 窗 格 内 移动 ,也 可 以 在 不 同窗 
格 间 移动 。 但 不 能 将 窗口 移动 到 编辑 器 窗 格 内 。 编 辑 器 窗 格 只 能 包含 文档 ,不 能 包含 其 他 
窗口 。 反 过 来 ,也 不 能 把 文档 标签 移 到 编辑 器 窗 格 之 外 。 


1.4 ”Web 应 用 示例 


这 里 ,通过 一 个 现 有 Web 应 用 的 打开 、 yagi 感性 地 认识 一 下 Web 应 用 的 组 成 
及 运行 原理 ,并 熟悉 NetBeans IDE 的 一 些 基本 操作 。 这 个 简单 Web 应 用 的 文档 根 目 录 为 
chl_hello, 其 中 仅 包含 两 个 页 面 : 一 个 是 html 一 个 是 servlet 动态 页 面 。 


1.4.1 打开 并 查看 Web 应 用 


1. 打开 Web 应 用 

在 NetBeans IDE 中 ,从 “文件 "菜单 中 选择 “打开 项 目 ” 命 令 , 然 后 在 “打开 项 目 ” 对 话 框 
中 定位 并 选择 项 目 文件 夹 , 即 Web 应 用 的 文档 根 目 录 (chl_hello), 最 后 单 击 “ 打 开 项 目 ” 命 
令 按 钮 打开 该 Web 应 用 。 

2. 查看 hello. html 

Web 应 用 打开 后 ,项 目 窗口 中 会 出 现 一 个 相应 的 项 目 结 点 ch_hello。 展 开 该 项 目 结 点 
下 的 “Web 页 ? 结 点 ,然后 双击 hello. html 文件 ,可 以 在 编辑 器 窗 格 中 打开 该 文件 。 该 页 面 
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非常 简单 , 仅 显 示 一 行 静态 文本 。 具 体 代 码 见 代码 清单 1-1。 
代码 清单 11 HTML 文档 示例 


1. < !DOCTYPE HTML PUBLIC "- //W3C//DTD HTML 4.01 Transitional//EN"> 
2. <html> 

3. <head> 

4 <title></title> 

<meta http-equiv="Content-Type" content="text/html;charset=UTF- 8"> 
6 </head> 

Ps <body> 

8 <h3> 欢 迎 进入 Web 世界 !</h3> 

9 </body> 

0. </html> 


3. 查看 Hello. java 

展开 该 项 目 结 点 下 的 “ 源 包 ” 结 点 ,然后 再 展开 servlet 子 结 点 ,并 双击 其 中 的 Hello. java 
文件 ,可 以 在 编辑 器 窗 格 中 打开 该 文件 。 该 servlet 获取 当前 日 期 时 间 , 然 后 利用 一 个 日 期 
格式 器 将 其 转换 成 一 个 默认 格式 的 文本 并 输出 。 具 体 代码 见 代 码 清 单 1-2。 

代码 清单 1-2 ”servlet 示例 


. Package servlet; 

. import java.io.IOException; 

. import java.io.PrintWriter; 

. import java.text.DateFormat; 

. import java.util.Date; 

. import javax.servlet.annotation.WebServlet; 


. import javax.servlet.ServletException; 
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。import javax.servlet.http.HttpServlet; 
9. import javax.servlet.http.HttpServletRequest; 
10. import javax.servlet.http.HttpServletResponse; 


12. @WebServlet (name="Hello",urlPatterns={"/Hello"}) 
13. public class Hello extends HttpServlet { 
14. protected void processRequest (HttpServletRequest request,HttpServletResponse 


Ls response)throws ServletException,IOException { 

16. response.setContentType ("text/html;charset=UTF- 8"); 
Ne PrintWriter out =response.getWriter(); 

18. try { 

19 。 out.println("<html>"); 

20. out.println("<head><title>Servlet</title></head>"); 
2 out.println("<body>"); 

Rs Date date =new Date(); 

23。 String current =DateFormat .getDateInstance () .format (date) 
24. out.println ("<h3> 欢 迎 访 问 Servlet</h3>"); 

5 out .println("<h3> 当 前 日 期 : " +current +"</h3>"); 

26. out.println("</body>"); 


Py out.println("</html>"); 


28. } finally { 
29: out .close (); 
30 . } 

31。 于 

32 


33. override 
34. Protected void doGet (HttpServletRequest request,HttpServletResponse response) 


35。 throws ServletException,IOException { 
36. processRequest (request,response); 

37。 } 

38. 


39. override 
40. protected void doPost (HttpServletRequest request,HttpServletResponse response) 


41. throws ServletException,IOException { 
42. processRequest (request,response); 

43. * 

44. } 


一 个 servlet 动态 页 通常 通过 扩展 HttpServlet 抽象 类 定义 ,其 中 doGet 方法 用 于 处 理 
GET 请 求 , doPost 方法 用 于 处 理 POST 请 求 。 该 servlet 覆盖 了 这 两 个 方法 ,使 得 无 论 是 
GET 请 求 还 是 POST 请 求 ,都 将 由 processRequest 方法 产生 响应 。 

该 servlet 类 的 @WebServlet 标注 指明 : 该 servlet 的 名 称 是 Hello,url 模式 是 /Hello。 

4. 查看 sun-web. xml 

当 利用 NetBeans IDE 创建 一 个 Web 应 用 ,并 以 GlassFish 作为 服务 器 时 ,IDE 会 自动 
产生 一 个 sun-web. xml 文件 。 该 文件 位 于 ”Web 页 ” 结 点 下 的 ”WEB-INF? 子 结 点 中 ,双击 
该 文件 ,可 以 在 编辑 器 窗 格 中 打开 它 。 该 文件 中 的 context-root 元 素 指定 了 Web 应 用 的 上 
下 文 路 径 。 


<context-root>/chl hello</context- root> 


默认 情况 下 , Web 应 用 的 上 下 文 路 径 与 创建 时 指定 的 项 目 名 称 是 一 致 的 ,需要 时 也 可 
以 在 此 重新 指定 。 


1.4.2 部 署 和 访问 Web 应 用 


在 客户 访问 Web 应 用 前 , Web 应 用 需要 先 被 部 署 到 Web 服务 器 中 。 有 些 场合 , Web 
服务 器 可 以 根据 Web 应 用 的 文档 根 目 录 直 接 进行 部 署 。 而 在 另外 一 些 场合 ,一 个 Web 应 
用 必须 先 被 打包 成 WAR 文件 ,然后 再 在 Web 服务 器 上 部 署 。 

1. 打包 Web 应 用 

要 打包 本 示例 的 Web 应 用 ,可 以 在 "项 目 ” 窗 口中 , 右 击 Web 应 用 对 应 的 项 目 结 点 , 即 
chl_hello, 然 后 在 打开 的 快捷 菜单 中 选择 “生成 "或 清理 并 生成 "命令 。 

打包 产生 的 chl_hello. WAR 文件 存放 在 Web 应 用 文档 根 目录 下 的 dist 子 目录 中 。 在 
“文件 ”窗口 中 可 以 发 现 它 的 存在 。 
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2. 部 署 Web 应 用 

要 部 署 本 示例 的 Web 应 用 ,可 以 在 “项 目 ” 窗 口中, 右 击 Web 应 用 对 应 的 项 目 结 点 , 即 
chl_hello, 然 后 在 打开 的 快捷 菜单 中 选择 “部署 命令。 

部 署 Web 应 用 时 ,如 果 相 应 的 Web 服务 器 还 没有 启动 ,NetBeans IDE 会 先 自动 启动 
服务 器 。 

3. 访问 Web 应 用 

一 旦 部 署 了 Web 应 用 ,客户 就 可 以 通过 浏览 器 访问 它 了 。 上 面 ,已 经 将 示例 的 Web 应 
用 部 署 到 了 本 地 主机 (localhost) 的 GlassFish 服务 器 (端口 号 为 8080) 上 , 且 其 上 下 文 路 径 
为 /chl_hello, 因 此 可 以 在 浏览 器 地 址 栏 中 输入 以 下 URL 访问 相应 的 页 面 。 

访问 静态 页 面 hello. html 的 URL 为 : http://localhost: 8080/chl_hello/hello. html， 
显示 效果 如 图 1-7 所 示 。 

访问 servlet 动态 页 面 Hello 的 URL 为 : http://localhost:8080/chl_hello/Hello, 显 
示 效 果 如 图 1-8 所 示 。 


Hozilla Firefox 图 占 区 文件 FE) 编辑 GE) 
编辑 外) 


€ > > “| http://locslhost:8080/chl_hello/Hello 
欢迎 访问 Servlet 
当前 日 期 : 2012-8-10 


Be] - BW [DB hp://ocahost: 8080/chl_hello/hello htnl 


欢迎 进入 Web 世 界 ! 


图 1-7 请 求 静态 页 面 hello. html 图 1-8 请 求 servlet 动态 页 面 Hello 


4. 取消 部 署 

在 NetBeans IDE 环境 下 ,可 以 随时 查看 服务 器 上 部 署 有 哪些 Web 应 用 ,也 可 以 很 方便 
地 将 某 个 Web 应 用 取消 部 署 。 

在 “服务 ”窗口 中 ,依次 展开 “服务 器 ”“Glassfish Server 3” 和 “应 用 程序 ” 结 点 ,可 以 查 
看 在 Glassfish 服务 器 上 部 署 的 各 个 应 用 程序 ,其 中 应 该 包含 本 示例 Web 应 用 对 应 的 chl_ 

要 取消 本 示例 Web 应 用 的 部 署 ,可 以 右 击 chl_hello 结 点 ,然后 从 打开 的 快捷 菜单 中 选 
择 “ 取 消 部 署 " 命 令 。 取 消 部 署 后 ,用 户 就 不 能 对 该 Web 应 用 进行 访问 了 ,除非 对 其 重新 
部 署 。 


1.5 小 结 


。 万 维 网 是 因特网 上 最 主要 的 信息 服务 形式 ,也 是 Web 应 用 的 载体 。 

。 万 维 网 技术 的 核心 包括 统一 资源 定位 符 (URL) 、 超 文本 传输 协议 (HTTP) 和 超 文 本 
标记 语言 (HTML)。 

。 Web 应 用 由 一 些 不 同性 质 和 作用 的 元 素 组 成 .这 些 元 素 按 特定 的 结构 组 织 , 存 储 在 
Web 应 用 文档 根 目录 下 。 


2. 
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4. 


Web 容器 是 Web 组 件 的 运行 平台 ,提供 诸如 请 求 派发 .生命 周期 管理 、 安 全 性 、 并 发 
性 、 事 务 处 理 、 部 署 等 服务 。 

一 个 Web 应 用 部 署 到 Web 服务 器 后 称 为 一 个 上 下 文 ,每 个 上 下 文 有 一 个 上 下 文 
Web 应 用 的 生命 周期 大 致 包括 开发 静态 资源 和 Web 组 件 、 定 义 部 署 描述 符 和 其 他 
配置 文件 编译 Java 类 和 构建 Web 应用、 打包 Web 应 用 和 部 署 Web 应 用 以 及 访问 
Web 应 用 等 几 个 阶段 。 


习 题 1 


. 术语 解释 。 


万 维 网 ; 

URL; 

HTTPS 

HTML; 

Web 应 用 ; 

上 下 文 与 上 下 文 路 径 。 

简 述 Web 应 用 的 组 成 及 目录 结构 。 


. 简 述 Web 应 用 的 生命 周期 。 


先 下 载 并 解压 本 章 介 绍 的 Web 应 用 项 目 chl_hello. 然 后 完成 以 下 操作 。 


(1) 在 NetBeans 中 打开 该 项 目 ,并 查看 其 中 html 页 文件 (hello. html) 、servlet 页 文件 


(CHello 


.java) 和 配置 文件 (sun-web. xml) 的 代码 。 


(2) 部 署 该 Web 应 用 ,然后 通过 浏览 器 请 求 上 述 的 html 页 和 servlet 页 。 

(3) 在 该 Web 应 用 项 目的 servlet 包 中 新 建 一 个 名 为 Calculator 的 servlet 类 ,将 其 
URL 模式 设 为 /calculator。 该 Servlet 页 的 功能 是 计算 并 输出 半径 为 1.2、3、4 和 5 的 圆 的 
面积 和 周 长 ,其 显示 效果 如 图 1-9 所 示 。 
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) Servlet_Calculator -了 ozilla Firefoz 同 问 ] 品 | 


文件 F) 编辑 全 ) 查看 WY) 历史 G) 书签 @) 工具 GD) 帮助 gd 


二- 续 -[B Mt /lochost:e000/chi hello/ealedlator |[m 


计算 国 的 面积 和 周 长 : 

半径 为 1 的 圆 ， 面 积 : 3.14， 周 长 : 6. 28 
半径 为 2 的 圆 ， 面 积 : 12. 57， 周 长 : 12. 57 
半径 为 3 的 圆 ， 面 积 : 28. 27， 周 长 : 18. 85 
半径 为 4 的 圆 ， 面 积 : 50. 27， 周 长 : 25.13 
半径 为 5 的 圆 ， 面 积 : 78. 54， 周 长 : 31. 42 


完成 


图 1-9 第 4 题 示意 图 


第 2 章 JSF 基础 


本 章 主题 : 

。 什么 是 JSF 

。 JSF 与 MVC 之 间 的 关系 
。 JSF 标记 与 JSF 组 件 

。 组 件 与 呈现 器 

。 JSF 请 求 处 理 生命 周期 
。 一 个 简单 的 JSF 应 用 


了 解 JSF 标记 \ 组 件 、 组 件 树 、 呈 现 器 等 概念 ,可 以 更 好 地 理解 JSF 请 求 处 理 生 命 周期 。 
理解 了 JSF 请 求 处 理 生命 周期 ,有 利于 熟悉 JSF 的 工作 原理 ,从 而 更 加 有 效 地 学 习 JSF 的 
各 个 知识 点 。 理 解 MVC 设计 架构 ,能够 提供 有 关 JSF 应 用 总 体 结构 的 一 个 指导 思想 。 

本 章 最 后 通过 一 个 简单 的 JSF 应 用 ,介绍 JSF 应 用 的 开发 过 程 ,以 及 JSF 应 用 的 基本 
组 成 。 


2.1 JSF 概述 


JSF 是 Sun 公司 继 JSP 技术 之 后 推出 的 又 一 项 Java Web 应 用 开发 技术 。JSF 对 Web 
应 用 的 一 般 特性 进行 了 抽象 ,提出 了 以 组 件 为 中 心 的 事件 驱动 编程 模型 ,实现 了 应 用 表示 层 
和 业务 层 的 明确 分 离 ,便于 Web 应 用 的 有 效 开发 。 


2.1.1 JSF 的 定义 


JSF(JavaServer Faces) 是 一 种 基于 Java 的 Web 应 用 的 用 户 界面 软件 框架 , 它 提供 了 一 
种 以 组 件 为 中 心 .事件 驱 动 的 用 户 界 面 构建 方法 , 旨 在 降低 Web 应 用 的 开发 难度 .减轻 开发 
人 员 编 写 和 维护 Web 应 用 的 负担 。 

所 谓 软件 框架 是 指 对 某 种 类 型 的 软件 的 一 种 抽象 ,是 该 类 软件 的 一 个 半成品 。 框 架 通 
常 定义 了 这 种 软件 的 结构 ,控制 流程 ,并 提供 实现 一 般 功能 的 公共 代码 。 软 件 开发 者 可 以 基 
于 框架 ,通过 覆盖 、 扩 展 一 些 组 件 来 创建 特定 的 应 用 软件 。 

JSF 框架 作为 一 个 软件 半成品 ,可 以 由 不 同 的 软件 厂商 提供 ,但 其 本 身 的 规范 目前 由 
Oracle 公司 控制 和 维护 。 最 早 的 JSF 规范 是 JSF 1.0, 于 2004 年 3 月 发 布 。2006 年 5 月 ， 
推出 了 通过 改进 的 JSF 1.2, 并 随 Java EE 5 一 同 发 布 。2009 年 6 月 推出 的 JSF 2.0, 无 论 在 
功能 还 是 在 性 能 上 都 有 了 很 大 的 提升 ,是 Java EE 6 标准 的 一 部 分 。 

JSF 框架 存在 于 各 种 Java EE 应 用 服务 器 ,如 GlassFish 服务 器 。JSF 框架 也 可 以 方便 
地 添加 到 诸如 Apache Tomcat 的 轻 量 级 Web 服务 器 中 。 

通常 ,如 果 一 个 Java Web 应 用 以 JSF 作为 其 表示 层 框 架 , 就 称 这 个 应 用 为 JSF 应 用 。 
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2.1.2 JSF 与 MVC 设计 架构 


MVC 是 Model-View-Controller 的 缩写 , 称 为 模型 一 视图 一 控制 器 设计 架构 。MVC 
架构 将 软件 分 割 为 松 耦 合 的 3 个 部 分 ,各 部 分 各 司 其 职 , 如 图 2-1 所 示 。 


图 2-1 MVC 设计 架构 


图 中 实 线 箭 头 表示 方法 或 功能 调用 ,虚线 箭头 表示 事件 传递 或 处 理 。 模 型 封装 应 用 软 
件 的 业务 逻辑 和 数据 ,负责 业务 逻辑 的 执行 和 业务 数据 的 查询 和 更 新 ,为 视图 和 控制 器 提供 
服务 。 当 模型 数据 变化 时 ,可 以 通知 对 此 数据 感 兴趣 的 视图 。 视 图 代表 用 户 交 互 界面 , 当 扮 
演 “ 输 入 ”角色 时 , 它 人 允许 用 户 输入 数据 或 引发 某 种 事件 ; 当 扮演 “输出 ?角色 时 , 它 能 从 模型 
获取 所 需 的 数据 并 呈现 给 用 户 。 控 制 器 负责 将 用 户 与 视图 交互 引发 的 事件 转换 成 模型 执行 
的 动作 ,并 决定 作为 响应 的 视图 的 选择 。 

通常 ,用 作用 户 交 互 界 面 的 视图 被 称 为 应 用 的 表示 层 , 而 实现 业务 逻辑 的 模型 被 称 为 应 
用 的 业务 层 。 

MVC 架构 有 以 下 优点 。 

(1) 利于 软件 开发 。 软 件 各 成 分 按 其 职责 不 同 被 划分 为 相对 独立 的 3 个 部 分 ,各 部 分 
保持 松 耦 合 。 这 为 由 不 同 职能 的 人 员 、 小 组 相对 独立 地 开发 软件 的 特定 部 分 成 为 可 能 。 比 
如 ,模型 组 件 通常 可 以 独立 于 控制 器 和 视图 .由 专门 的 软件 人 员 单独 开 发 。 它 降低 了 软件 开 
发 的 难度 ,便于 软件 的 调试 .维护 和 重用 。 

(2) 一 个 模型 可 由 多 种 视图 共享 。 如 今 ,同一 个 Web 应 用 可 能 需要 提供 多 种 用 户 界 
面 ,例如 用 户 希 望 既 能 够 通过 浏览 器 来 收发 电子 邮件 .还 能 通过 手机 来 访问 电子 邮箱 。 这 就 
要 求 Web 网 站 同时 能 提供 Internet 界面 和 WAP 界面 ,但 两 种 视图 应 该 共享 同一 模型 。 

基于 JSF 框架 ,开发 人 员 可 以 很 好 地 遵循 MVC 设计 架构 开发 Web 应 用 。 当 然 , 对 于 
不 同类 型 的 软件 ,架构 各 部 分 的 实现 技术 及 各 部 分 的 通信 方式 都 可 能 有 所 不 同 。 在 JSF 应 
用 中 ,控制 器 由 JSF 框架 中 的 FacesServlet .导航 处 理 器 等 部 件 以 及 开发 人 员 提 供 的 事件 监 
听 器 等 组 成 。 视 图 由 开发 人 员 基 于 JSF 框架 设计 开发 的 JSF 页 面 组 成 。 模 型 可 以 由 普通 
的 Java 对 象 、. 受 管 bean 或 EJB 等 组 成 。 这 里 ,模型 是 相对 独立 的 ,但 通过 EL 表达 式 、 受 管 
bean 和 事件 处 理 机 制 , 可 以 简单 而 有 效 地 在 视图 和 模型 控制 器 和 模型 之 间 建 立 沟通 。 


2.1.3 JSF 角色 


JSF 框架 是 JSF 规范 的 一 种 实现 ,JSF 应 用 是 基于 JSF 框架 开发 的 一 种 Web 应 用 。 
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JSF 规范 为 JSF 这 个 世界 定义 了 JSF 实现 者 .工具 提供 者 、 页 面 制作 者 、 组 件 编写 者 和 应 用 
开发 者 等 5 种 不 同 角色 ,它们 有 各 自 的 职责 
1. JSF 实现 者 
负责 按照 JSF 规范 开发 具体 的 JSF 框架 。 由 于 JSF 规范 是 Java EE 标准 的 一 部 分 ,所 
以 实现 Java EE 标准 的 应 用 程序 服务 器 也 应 该 包含 JSF 框架 ,如 GlassFish 。 
2. 工具 提供 者 
负责 提供 支持 JSF 应 用 开发 的 各 种 工具 ,如 NetBeans、Eclipse 等 。 这 些 工具 可 以 帮助 
应 用 开发 者 方便 地 创建 组 件 、 设 计 页 面 、 实 施 应 用 的 配置 管理 等 ,并 使 开发 的 JSF 应 用 能 移 
de 框架 间 。 
.页 面 制 作者 
RE 实现 JSF 应 用 的 用 户 界面 。 页 面 制作 者 一 般 应 擅长 图 形 
设计 ,颜色 搭配 和 页 面 布局 ,熟悉 客户 端 理 解 的 标记 语言 (如 HTML)、 脚 本 语言 (如 
JavaScript) ,以 及 产生 动态 内 容 的 呈现 技术 (如 JSF 标记 ) ,但 通常 不 需要 具备 丰富 的 程序 设 
计 ( 如 Java、Visual Basic) 能 力 。 
4. 组 件 编写 者 
负责 开发 自 定义 UI 组 件 . 呈 现 器 转换 器 、 验 证 器 以 及 与 用 户 界面 相关 的 事件 处 理 器 ， 
构建 可 重用 的 用 户 界面 组 件 库 。JSF 的 UI 组 件 一 般 提供 以 下 功能 。 
。 编码 。 将 组 件 属性 的 内 部 表示 转换 为 呈现 页 的 适当 标记 。 
。 解码 。 将 一 个 请 求 的 属性 (请 求 参 数 、 头 信息 、Cookies) 转 换 后 存 人 组 件 的 相应 属 
性 中 。 
。 响应 事件 并 改变 组 件 的 外 观 。 
。 支持 对 用 户 输入 合法 性 的 检验 。 
。 在 请 求 之 间 保 存 和 恢复 组 件 状 态 。 
5. 应 用 开发 者 
负责 开发 JSF 应 用 的 服务 器 端 功能 ,这 些 功能 与 用 户 界面 没有 直接 的 关系 。 应 用 开发 
者 一 般 要 担负 以 下 职责 
。 定义 持久 性 存储 机 制 , 如 设计 和 创建 关系 数据 库 。 
。 创建 表示 持久 性 数据 和 实现 持久 性 功能 的 相关 软件 .如 实体 类 、 受 管 bean、EJB 等 。 
。 创建 封装 JSF 应 用 功能 或 业务 逻辑 的 相关 软件 ,如 普通 Java 类 、 受 管 bean、EJB 等 。 
。 以 适当 方式 向 JSF 应 用 的 表示 层 暴露 业务 数据 和 业务 逻辑 。 
通常 ,开发 一 个 JSF 应 用 仅 涉 及 后 面 3 种 角色 . 即 页 面 制 作者 、 组 件 编写 者 和 应 用 开发 
者 。 每 种 角色 所 需 开 发 人 员 数 量 会 因应 用 项 目的 规模 和 性 质 不 同 而 不 同 , 一 个 开发 人 员 也 
可 能 扮演 多 种 角色 。 


2.2 JSF 组 件 


JSF 技术 的 核心 是 组 件 技术 , 它 将 用 户 界面 元 素 表示 为 可 重用 Java 组 件 对 象 , 将 
HTTP 请 求 参 数 看 作为 相关 组 件 对 象 的 新 状态 ,从 而 为 在 Web 应 用 中 引入 基于 组 件 的 事 


件 驱 动 编程 模型 商定 了 技术 基础 。 
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2.2.1 组 件 与 组 件 标记 


JSF 页 面 文件 主要 由 JSF 标记 组 成 ,每 个 标记 都 有 相关 的 标记 处 理 程序 。 当 客户 访问 
一 个 JSF 页 面 时 ,JSF 框架 将 读 取 该 JSF 页 面 文件 ,解析 各 JSF 标记 、 执 行 相应 的 标记 处 理 
程序 ,并 构建 相应 的 组 件 树 。 

组 件 树 中 的 组 件 是 组 件 类 的 实例 对 象 ,是 JSF 页 面 文件 中 的 标记 在 服务 器 端的 内 部 表 
示 。 每 个 组 件 都 有 自己 的 属性 及 相关 的 访问 方法 。 组 件 树 又 称 为 视图 ,是 JSF 页 面 在 服务 
器 端的 内 部 表示 。 视 图 一 旦 创建 便 被 保存 在 当前 的 FacesContext 对 象 中 。 

组 件 树 的 根 是 UIViewRoot 对 象 ,通过 该 对 象 可 以 访问 组 件 树 中 的 所 有 组 件 。 下 面 代 
码 可 以 获得 当前 正在 处 理 的 视图 的 组 件 树 的 根 : 


UIViewRoot root=FacesContext.getCurrentInstance() .getViewRoot () 7 
图 2-2 是 一 个 组 件 树 示意 图 。 该 图 表明 ,该 组 件 树 根 结 点 下 有 多 个 组 件 实例 ,其 中 一 个 
UIOutput 型 组 件 可 能 对 应 于 JSF 页 面 文件 中 的 h:body 标记 , 它 有 一 个 HtmlForm 型 子 组 


件 ,该 子 组 件 下 又 包含 一 个 HtmlOutputLable 型 子 组 件 、 一 个 HtmlInputText 型 子 组 件 和 
一 个 HtmlCommandButton 型 子 组 件 。 


UIViewRoot 


UIOutput 


HtmlForm 


HtmlOutputLabel HtmlInputText HtmlCommandButton 


图 2-2 组 件 树 示意 图 


说 明 : 这 里 把 JSF 页 面 在 服务 器 端的 内 部 表示 ( 即 组 件 树 ) 称 为 视图 ,但 从 MVC 架构 
的 角度 来 考虑 JSF 应 用 ,JSF 页 面 本 身 也 经 常 被 称 为 视图 。 


2.2.2 呈现 器 


在 服务 器 内 部 ,一 个 被 客户 请 求 的 JSF 页 面 被 转换 成 一 棵 组 件 树 。 当 响应 时 ,组 件 树 
中 的 组 件 需 要 由 特定 的 对 象 进行 处 理 、 产 生 输 出 ,这 种 对 象 称 为 呈现 器 (renderer)。 整 个 组 
件 树 产生 的 输出 就 是 服务 器 对 客户 请 求 的 响应 。 

呈现 器 被 组 织 成 呈现 包 (renderkit) ,每 个 呈现 包 通 常用 于 特定 类 型 的 输出 , 即 相同 的 组 
件 树 采用 不 同 的 呈现 包 , 可 产生 不 同类 型 的 输出 ,如 HTMIL、WML 等 。JSF 规范 要 求 , 所 有 
的 JSF 实现 ( 即 JSF 框架 ) 必 须 提供 与 HTML4.01 兼容 的 HTML 呈现 包 , 以 便 能 对 JSF 页 
面 (视图 ) 进 行 处 理 、 产 生 标准 的 HTML 文档 。 

说 明 : 呈现 包 不 是 Java 包 , 而 是 一 种 Java 对 象 ,用 于 管理 一 组 呈现 器 。 

呈现 器 既 负 责 从 服务 器 端 组 件 到 客户 端 响应 的 转换 ,也 负责 对 请 求 参数 进行 解析 并 将 
其 保存 在 服务 器 端 特定 的 组 件 内 。 可 以 将 呈现 器 想象 成 服务 器 和 客户 机 之 间 的 翻译 。 当 
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JSF 从 客户 端 接 收 到 一 个 请 求 时 ,呈现 器 将 进行 解码 (decoding), 即 提取 与 组 件 相 关 的 请 求 
参数 并 保存 于 组 件 中 。 当 要 产生 响应 时 ,呈现 器 将 进行 编码 (encoding), 即 创建 客户 能 理解 
的 组 件 的 表示 方式 。 

例如 ,客户 请 求 的 JSF 页 面 文件 中 包含 以 下 标记 : 


<h:inputText id="inputl" size="20" maxlength="30"/> 


当 JSF 框架 接受 并 处 理 请 求 时 ,将 创建 一 棵 组 件 树 ,组 件 树 中 包含 与 上 述 标 记 相对 应 
的 HtmlInputText 型 组 件 。 响 应 时 , 旦 现 器 将 对 组 件 进行 编码 产生 如 下 HTML 标记 : 


<input id="forml:inputl" name="forml:inputl1" type="text" maxlength="30" size="20"/> 


呈现 功能 既 可 以 由 特定 呈现 器 来 完成 , 称 为 委托 实现 ,也 可 以 由 组 件 自身 完成 , 称 为 直 
接 实现 。 


2.2.3 组件 标识 符 和 客户 端 标识 符 


每 个 组 件 可 以 有 一 个 组 件 标识 符 。 组 件 标 识 符 可 以 在 组 件 标 记 中 用 id 属性 指定 。 如 
果 页 面 制作 者 没有 为 组 件 指定 标识 符 , 需 要 时 JSF 框架 会 自动 为 组 件 指 定 标 识 符 。 

标识 符 必须 以 字母 下划线 打头 ,并 且 由 字母 数字、 连 字符 ,下划线 组 成 。 对 命名 容器 
(NamingContainer) 组 件 ( 如 HTMLForm、HtmlDataTable) ,其 所 有 子 组 件 都 应 该 有 唯一 的 
标识 符 ,但 不 同 命 名 容器 组 件 中 子 组 件 的 标识 符 可 以 相同 。 在 服务 器 端 ,可 以 通过 组 件 的 
getId() 和 setId(String) 访 问 组 件 标 识 符 。 

一 个 组 件 可 以 有 一 个 客户 端 标识 符 。 客 户 端 标 识 符 是 指 组 件 呈 现 产生 的 HTML 标记 
的 标识 符 (id 属性 )。 一 般 情况 下 ,组 件 的 客户 端 标 识 符 与 其 组 件 标识 符 相 同 。 

在 一 棵 组 件 树 中 ,有 些 组 件 的 标识 符 是 可 以 相同 的 ,但 在 一 个 HTML 文档 中 ,所 有 标 
记 的 id 属性 都 应 该 是 唯一 的 。 为 满足 这 一 要 求 ,JSF 框架 一 般 将 命名 容器 组 件 中 的 组 件 的 
客户 端 标 识 符 设置 为 : 去 命名 容器 组 件 的 客户 端 标识 符 二 :去 组 件 自 身 标识 符 之 。 比 如 , 若 
表单 组 件 (标识 符 为 forml) 中 有 一 个 文本 域 子 组 件 (标识 符 为 input1), 则 该 文本 域 子 组 件 
的 客户 端 标识 符 将 被 设置 为 forml :inputl 。 


2.3 请求 处 理 生 命 周 期 


JSF 是 一 种 Java Web 应 用 的 表示 层 框架 ,其 主要 内 容 是 对 处 理 HTTP 请 求 的 过 程 进 
行 了 抽象 ,并 就 其 总 体 结构 、 公 共 服 务 等 提供 了 实现 。 它 用 组 件 树 (视图) 来 表示 一 个 JSF 
页 面 ,将 请 求 参 数 存储 为 相应 组 件 的 状态 ,将 用 户 单 击 递交 按钮 模拟 为 递交 按钮 组 件 引 发 了 
动作 事件 等 。JSF 规范 定义 了 处 理 请 求 的 整个 过 程 一 一 请 求 处 理 生命 周期 。 这 一 过 程 主要 
由 恢复 视图 、 应 用 请 求 值 、 处 理 验 证 、 更 新 模型 值 、 调 用 应 用 和 呈现 响应 等 6 个 阶段 组 成 ,如 
图 2-3 所 示 。 

图 中 实 线 所 示 是 一 个 正常 的 控制 流 ,虚线 是 一 些 可 选 的 控制 流 。JSF 处 理 一 个 请 求 时 ， 
大 多 数 阶段 后 ,都 会 将 合适 的 事件 广播 到 相应 的 事件 监听 器 。 事 件 监 听 器 在 处 理 完事 件 后 
可 以 正常 地 进入 下 一 阶段 ,也 可 以 跳 过 其 他 阶段 直接 进入 呈现 阶段 ,或 跳 过 其 余 所 有 阶段 并 
由 自己 呈现 响应 。 
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1 
1 
1 事件 监听 器 验证 或 转换 错误 1 
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图 2-3 JSF 请 求 处 理 生命 周 期 


2.3.1 阶段 1: 恢复 视图 


在 JSF 中 ,可 以 将 客户 对 JSF 页 面 的 请 求 分 为 回 送 (postback) 请 求 和 直接 请 求 两 大 类 。 
回 送 请 求 是 POST 请 求 ,而 直接 请 求 通常 是 GET 请 求 。 

回 送 请 求 是 指 先 将 请 求 提交 给 当前 页 面 白 身 .然后 在 服务 器 端 经 过 导航 处 理 再 转 至 目 
标 页 面 (也 可 能 是 当前 页 面 ) 的 请 求 。 对 回 送 请 求 ,JSF 框架 首先 会 恢复 页 面 视图 ,然后 进入 
请 求 处 理 后 续 阶 段 。 作 为 回 送 请 求 的 结果 ,浏览 器 窗口 中 显示 的 目标 页 面 与 浏览 器 地 址 栏 
中 的 URL 通常 是 不 一 致 的 。 

直接 请 求 是 指 发 送 请 求 时 有 明确 的 目标 页 面 \ 且 指定 在 请 求 URL 中 的 请 求 。 作 为 直 
接 请 求 的 结果 ,浏览 器 窗口 中 显示 的 目标 页 面 与 浏览 器 地 址 栏 中 的 URL 通常 是 一 致 的 。 

直接 请 求 又 可 分 为 目标 页 面 含 视图 参数 和 不 含 视图 参数 两 种 。 对 目标 页 面 不 含 视图 参 
数 的 直接 请 求 ,JSF 框架 会 创建 页 面 视 图 ,然后 跳 过 其 他 阶段 .直接 进入 呈现 响应 阶段 。 对 
目标 页 面 含 视图 参数 的 直接 请 求 ,JSF 框架 会 先 创建 页 面 视图 ,然后 进入 下 一 阶段 ,完成 应 
用 请 求 值 ,处 理 验证 等 相关 处 理 。 

视图 一 旦 被 创建 或 恢复 ,将 被 保存 在 当前 的 FacesContext 对 象 中 。 
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2.3.2 阶段 2: 应 用 请 求 值 


首先 ,JSF 框架 会 将 所 有 的 请 求 参数 保存 在 一 个 映射 中 ,映射 中 每 个 元 素 是 一 个 请 求 参 
数 的 名 称 一 值 对 。 然 后 ,每 个 组 件 ( 或 其 呈现 器 ) 从 请 求 参数 映射 中 查找 属于 自己 的 请 求 参 
数 。 一 旦 找到 ,将 根据 组 件 类 型 进行 相应 的 处 理 。 
。 若 为 EditableValueHolder 组 件 ( 如 UIInput) ,参数 值 被 保存 在 组 件 中 。 这 个 值 称 为 
被 提交 值 (submitted value)。 
。 车 为 ActionSource 组 件 ( 如 UICommand), 表 明 该 组 件 被 激活 , 则 产生 一 个 动作 事 
件 (ActionEvent) 放 入 事件 队列 。 
说 明 : 
(1) 通常 ,对 组 件 值 的 验证 处 理 将 在 下 一 阶段 进行 ,但 对 直接 组 件 ( 其 immediate 属性 
值 为 true) ,组 件 值 的 验证 处 理会 在 本 阶段 立即 进行 ,并 可 能 会 引发 转换 或 验证 错误 。 
(2) 通常 ,动作 事件 的 处 理 将 在 调用 应 用 阶段 进行 ,但 对 直接 组 件 ( 其 immediate 属性 
值 为 true) 引 发 的 动作 事件 会 在 本 阶段 立即 处 理 ,并 经 导航 处 理 后 直接 进入 呈现 响应 


阶段 。 
2.3.3 阶段 3: 处 理 验证 


在 该 阶段 ,JSF 框架 遍历 组 件 树 并 验证 每 个 组 件 的 被 提交 值 是 否 有 效 。 

。 由 相关 的 标准 转换 器 或 自 定义 转换 器 对 被 提交 值 进行 数据 类 型 或 格式 转换 ; 

。 若 组 件 的 required 属性 值 为 true, 检 查 已 进行 转换 处 理 的 被 提交 值 是 否 空 ; 

。 由 相关 的 标准 验证 器 或 自 定义 验证 器 对 已 进行 转换 处 理 的 被 提交 值 进 行 正确 性 

检查 。 

如 果 转 换 和 验证 成 功 , 组 件 的 被 提交 值 转换 为 本 地 值 。 此 时 可 能 触发 值 变化 事件 并 被 
相关 的 监听 器 处 理 , 然 后 转 入 请 求 处 理 生 命 周 期 的 下 一 阶段 。 值 变化 事件 监听 器 可 以 跳 过 
其 余 阶 段 转 至 呈现 响应 阶段 ,或 直接 产生 响应 。 

如 果 转 换 或 验证 失败 ,将 附带 转换 或 验证 错误 信息 进入 呈现 响应 阶段 。 


2.3.4 阶段 4: 更 新 模型 值 


进入 该 阶段 时 ,所 有 组 件 的 本 地 值 都 具有 正确 的 类 型 , 且 是 有 效 的 。 
在 该 阶段 ,JSF 框架 将 基于 组 件 标 记 中 指定 的 值 绑 定 表达 式 , 用 组 件 的 本 地 值 更 新 支撑 
bean( 受 管 bean) 中 的 相关 属性 。 对 于 JSF 框架 来 说 , 受 管 bean 也 被 看 作 是 模型 的 一 部 分 。 


2.3.5 阶段 5: 调用 应 用 


进入 该 阶段 时 ,支撑 bean 已 被 更 新 。 
在 该 阶段 ,JSF 框架 将 向 所 有 已 注册 的 相关 监听 器 广播 动作 事件 ,执行 监听 器 方法 和 动 
作 方法 。 
监听 器 方法 和 动作 方法 可 以 调用 模型 对 象 的 有 关 方法 完成 相应 的 业务 处 理 。 业 务 处 理 
的 结果 可 以 保存 在 适当 的 支撑 bean 中 ,以 便 将 它们 包含 在 响应 中 。 
动作 方法 返回 一 个 结果 字符 串 给 导航 处 理 器 ,导航 处 理 器 以 此 决定 作为 响应 的 页 面 。 
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2.3.6 阶段 6: 呈现 响应 


进入 该 阶段 时 ,所 有 请 求 参数 处 理 和 业务 数据 处 理 都 已 经 完成 。 

本 阶段 的 主要 任务 是 完成 编码 工作 , 即 由 组 件 树 中 的 各 组 件 (或 其 呈现 器 ) 基 于 组 件 
状态 产生 客户 能 够 理解 的 表示 。 整 个 组 件 树 产生 的 输出 作为 响应 由 Web 服务 器 送 往 客 
户 端 。 若 作为 响应 的 页 面 不 同 于 当前 页 面 , 则 首先 创建 响应 页 面 的 视图 ,然后 再 完成 编 
码 工 作 。 

本 阶段 的 另 一 个 任务 是 保存 响应 页 面 视图 ,以 便 用 户 再 次 请 求 时 可 以 在 恢复 视图 阶段 
恢复 该 视图 。 视 图 可 以 保存 在 客户 端 ( 通 常 存 储 在 隐藏 域 中 ) 或 服务 器 中 (通常 在 会 话 对 
象 中 ) 。 


2.4 创建 一 个 简单 的 JSF 应 用 


通过 一 个 具有 登录 功能 的 JSF 应 用 ,熟悉 创建 JSF 应 用 的 一 般 过 程 , 了 解 JSF 应 用 的 
组 成 。 


2.4.1 登录 应 用 


这 是 一 个 实现 登录 功能 的 JSF 应 用 ,项 目 名 称 为 ch2_login。 当 应 用 运行 时 ,首先 显示 
一 个 登录 页 面 ,要 求 用 户 输入 用 户 名 和 密码 。 用 户 提交 用 户 名 和 密码 后 ,应 用 验证 用 户 名 和 
密码 是 否 正确 。 如 果 用 户 名 和 密码 正确 ,应 用 显示 一 个 登录 成 功 页 面 ,否则 显示 一 个 登录 失 
败 页 面 。 应 用 的 运行 效果 如 图 2-4 一 图 2-6 所 示 。 


Jch2 login 一 Wozilla Firefox 


文件 外 ) 


- -|G http://1ocalhost:e080/1ogin/ 四 


用 户 各 ex 
rr 


图 2-4 login 的 登录 页 面 
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你 好 ，James， 欢 迎 登录 。 


完成 


图 2-5 login 的 登录 成 功 页 面 
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登录 失败 ! 密码 错误 。 


完成 


图 2-6 login 的 登录 失败 页 面 


创建 本 应 用 的 具体 步骤 如 下 (在 “项 目 ? 窗 口中 进行 ) 。 

(1) 从 “文件 "菜单 ,选择 “新 建 项 目 " 命 令 , 打 开 “ 新 建 项 目 ” 对 话 框 。 

(2) 选择 项 目 类 型 : Java Web| Web 应 用 程序 。 

(3) 指定 项 目 名 称 : ch2_login, 然 后 根据 需要 选择 存放 项 目的 位 置 。 勾 选 “ 设 置 为 主 项 
目 ” 复 选 框 。 

(4) 选择 服务 器 : GlassFish Server 3 ,选择 Java EE 版 本 : Java EE 6 Web。 

(5) 选择 要 使 用 的 框架 : JavaServer Faces。 在 JavaServer Faces 配置 中 ,首选 页 面 语言 
采用 默认 的 Facelets 。 

(6) 单 击 “ 完 成 ”按钮 ,完成 应 用 项 目的 新 建 。 


2.4.2 创建 模型 


按照 MVC 架构 ,模型 实现 应 用 的 业务 逻辑 。 实 现 业务 逻辑 的 软件 组 件 可 以 是 普通 的 
Java 类 ,也 可 以 JSF 中 的 受 管 bean 或 Java EE 中 的 EJB。 本 书 主要 采用 一 些 简单 的 Java 
类 来 实现 所 需 的 业务 逻辑 。 

该 应 用 的 业务 逻辑 是 根据 用 户 名 和 密码 ,验证 用 户 身 份 是 否 合法 ,或 者 根据 用 户 名 , 返 
回 用 户 相应 的 密码 。 为 此 ,创建 了 两 个 Java 类 : DataBase. java( 代 码 清单 2-1) 模 拟 数 据 库 ， 
存放 注册 用 户 的 用 户 名 和 和 密码 信息 ;UserManager. java( 代 码 清单 2-2) 提 供 唯一 的 一 个 业 
务 方法 getPassword(String) ,该 方法 根据 指定 的 用 户 名 返回 相应 的 密码 。 如 果 用 户 名 不 合 
法 ,方法 返回 null。 两 个 类 都 存放 在 Java 包 model 中 。 

代码 清单 2-1 model. DataBase 


. Package model; 
. import java.util.HashMap; 


. import java.util.Map; 


. Public class DataBase { 
private static final Map<String,String>users =new HashMap<String,String> (); 
Static { 
users.put (" 李 晓 彤 ", "121212") ; 
users.put (" 刘 金辉 ","123456") 
30 users.put ("James","666666"); 
1 . 
12. Public static Map<String,String>getUsers (){ 


ownamoumwwN 


13。 return users; 


。2]1 。 


代码 清单 2-2 model. UserManager 


1. package model; 
2. import java.util.Map; 


E 

4. public class UserManager { 

5 public String getPassword(String username){ 

6. Map<String,String>users =DataBase.getUsers (); 
return users.get (username); 

8 } 

Ds 


创建 本 应 用 模型 的 具体 步骤 如 下 (在 项目" 窗口 中 进行 )。 

(1) 创建 Java 包 。 

Q@ 单 击 选择 项 目的 “ 源 包 ” 结 点 。 

@ 从 “文件 "菜单 ,选择 “新 建文 件 ” 命 令 , 打 开 “ 新 建文 件 ” 对 话 框 。 
@ 选择 文件 类 型 : Java|Java 包 。 

@ 指定 包 名 : model, 然 后 单 击 “ 完 成 ”按钮 。 

(2) 创建 Java 类 。 

@ 单 击 选择 存放 Java 类 的 包 结 点 model。 

@ 从 “文件 "菜单 ,选择 “新 建文 件 " 命 令 , 打 开 “ 新 建文 件 ” 对 话 框 。 
@ 选择 文件 类 型 : Java|Java 类。 

@ 指定 类 名 : DataBase, 然 后 单 击 “完成 "按钮 。 

@ 根据 代码 清单 2-1, 在 编辑 器 窗 格 中 完成 对 该 Java 类 的 定义 。 
用 同样 的 方法 可 以 创建 UserManager. java 文件 。 


2.4.3 创建 支撑 bean 


支撑 bean 是 一 种 受 管 bean, 它 在 JSF 页 面 和 模型 之 间 起 着 沟通 的 桥梁 作用 。 有 关 受 
管 bean 的 详细 内 容 将 在 第 3 章 做 进一步 介绍 。 

本 应 用 中 ,定义 了 一 个 文件 名 为 Login. java 的 支撑 bean( 代 码 清单 2-3) ,其 作用 有 以 下 
几 个 方面 。 

(1) 通过 name 属性 和 pw 属性 的 setter 方法 接收 并 保存 用 户 输入 的 用 户 名 和 密码 。 

(2) 动作 方法 action 通过 调用 业务 方法 判断 当前 用 户 的 身份 是 否 合 法 。 若 用 户 名 或 密 
码 有 错 , 设 置 相应 的 错误 信息 (errmsg) 。 方 法 根据 判断 结果 返回 相应 的 字符 串 。 

该 动作 方法 会 在 用 户 提 交 登 录 请 求 时 自动 调用 ,方法 的 返回 的 结果 会 作为 导航 处 理 器 
进行 导航 的 依据 。 

(3) 登录 成 功 页 面 会 通过 name 属性 的 getter 方法 获取 用 户 名 并 显示 。 登 录 失 败 页 面 
会 通过 errmsg 属性 的 getter 方法 获取 错误 提示 信息 并 显示 。 

吉 志 六 二 


代码 清单 2-3 ”支撑 bean(Login. java) 


. Package bean; 
. import javax.faces .bean.ManagedBean; 
. import javax.faces .bean.RequestScoped; 


. import model .UserManager; 


. ManagedBean 


. QRequestScoped 


oO amoDNDp 


. Public class Login { 


10. private String name; 


11. Ppublic String getName (){ 


12. return name; 

3 $ 

14. public void setName (String name){ 
15。 this.name=name; 

16s } 

17。 


18. private String pw; 
19. public String getPw(){ 


20, return pw; 

21, ; 

22. public void setPw(String pw){ 
人 this .pw=pw; 

24. } 

25 


26. private String errmsg; 


27. public String getErrmsg(){ 


28. return errmsg; 

29， 

30 . 

Es public String action(){ 

3 UserManager um=new UserManager (); 
Ss String password=um.getPassword (name); 
34. if (password==nu11){ 

35, errmsg=" 用 户 名 不 存在 。"; 

36, return "failure"; 

} else if(!password.equals (pw)){ 
38 . errmsg=" 密 码 错 误 。"; 

39， return "failure"; 

40. } 

41. return "success"; 

42. } 

43. } 


23 


上 述 类 定义 中 ,标注 @ManagedBean 指明 这 是 一 个 受 管 bean 类 ,标注 @RequestScoped 
指明 该 bean 的 范围 是 请 求 。 默 认 情 况 下 ,bean 的 名 称 与 类 名 是 一 致 的 (第 1 个 字母 为 小 
写 ) ,如 类 名 为 Login,bean 的 默认 名 称 为 login。 如 果 bean 的 名 称 与 类 名 不 一 致 ,可 在 标注 
@ManagedBean 中 用 name 属性 指定 ,如 @ManagedBean(name 一 "me")。 

创建 本 应 用 支撑 bean 的 具体 步骤 如 下 (在 “项 目 " 窗 口中 进行 )。 

(1) 创建 Java 包 。 

Q@ 单 击 选择 项 目的 “ 源 包 ” 结 点 。 

@ 从 “文件 "菜单 ,选择 “新 建文 件 " 命 令 , 打 开 “ 新 建文 件 ” 对 话 框 。 

@ 选择 文件 类 型 : Java|Java 包 。 

@ 指定 包 名 : bean, 然 后 单 击 “完成 ?按钮 。 

(2) 创建 支撑 bean。 

@ 单 击 选择 存放 支撑 bean 的 包 结 点 bean。 

@ 从 "文件 ?菜单 ,选择 “新 建文 件 ” 命 令 ,打开 ”新建 文件 "对话 框 。 

@ 选择 文件 类 型 : JavaServer Faces|JSF 受 管 Bean 。 

@ 指定 类 名 : Login,bean 名 称 取 默 认 的 login, 范 围 取 默认 的 request, 然 后 单 击 “ 完 成 ” 
按钮 。 

@ 根据 代码 清单 2-3 ,在 编辑 器 窗 格 中 完成 对 该 bean 类 的 定义 。 


2.4.4 创建 JSF 页 


采用 Facelets 技术 的 JSF 页 面 是 一 种 XHTML 文件 。login 应 用 一 共有 3 个 页 面 。 

。 登录 页 面 : login. xhtml; 

。 登录 成 功 页面 : success. xhtml; 

。 登录 失败 页 面 : failure. xhtml。 

login. xhtml 页 (代码 清单 2-4) 主 要 包含 一 个 用 户 名 文本 域 一 个 密码 文本 域 和 一 个 提 
交 按 钮 。 其 中 # {login. name} 和 # {login. pw} 是 两 个 EL 表达 式 。JSF 页 通过 EL 表达 式 
与 支撑 bean 建立 关联 。 比 如 EL 表达 式 #({login. name},login 是 bean 的 名 称 ,name 是 
bean 的 一 个 属性 。 当 用 户 提交 登录 时 ,输入 的 用 户 名 将 被 保存 到 login 支撑 bean 的 name 
属性 中 。 

代码 清单 2-4 ”登录 页 面 (login. xhtml) 


1. <?xml version='1.0' encoding= 'UTE-8' ?> 


2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 


3. "http://www.w3.0org/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
4. <html xmlns="http://www.w3.0rg/1999/xhtml" 
5 xmlns:h="http://java.sun.com/jsf/html"> 
6. <h:head> 
Ea <title>ch2 login</title> 
8. </h:head> 
9. <h:body> 
10. <h:form> 
11， <h:outputLabel for="username" value= "用 户 名 "/> 


是 有 5 <h:inputText id="username" value="#{login.name}" maxlength="15"/> 


Ls <p></p> 

14. <h:outputLabel for="password" value=" 密 码 "/> 

Ls <h:inputSecret id="password" value="#{1login.pw}" maxlength="15"/> 
16. <p></p> 

Ls <h:commandButton id="reset" value=" 重 置 " type="reset"/> 

18 . <h:commandButton id="submit" value= #{login.action}"/> 
19, </h:form> 

20. </h:body> 

21. </html> 


success. xhtml 页 (代码 清单 2-5) 主 要 显示 一 个 欢迎 信息 ,其 中 EL 表达 式 # {login. 
name) 会 从 login 支撑 bean 中 获取 name 属性 的 值 并 显示 。 
代码 清单 2-5 ”登录 成 功 页 面 (success. xhtml) 


1. <?xml version='1.0' encoding='UTF-8' ?> 
» <!DOCTYPE htm1l PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1l/DTD/xhtmll-transitional.dtd"> 
.<html xmlns="http://www.w3.0rg/1999/xhtml" 


2 
3 
4 
5» xmlns:h="http://java.sun.com/jsf/html"> 
6 <h:head> 
二 <title>ch2 login</title> 
8 </h:head> 

9. <h:body> 
10% 你 好 : #{1ogin.name}, 欢 迎 登 录 。 
11. </h:body> 
12. </html> 


登录 失败 页 面 failure. xhtml( 代 码 清单 2-6) 主 要 显示 一 个 登录 失败 的 信息 ,其 中 EL 表 
达 式 # {login. errmsg} 会 从 login 支撑 bean 中 获取 errmsg 属性 的 值 并 显示 。 
代码 清单 2-6 登录 失败 页 面 (failure. xhtml) 


1.<?xml version='1.0' encoding='UTF-8' ?> 
2. <!DOCTYPE html PUBLIC "- //W3C//DTD XHTML 1.0 Transitional//EN" 
3. "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
4. <html xmlns="http://www.w3.0rg/1999/xhtml" 
5 xmlns:h="http://java.sun.com/jsf/html"> 
6 <h:head> 
2 <title>ch2 login</title> 
8 </h:head> 
9. <h:body> 

2D 登录 失败 1#{login.errmsg} 

11. </h:body> 

12. </html> 


创建 JSF 页 面 的 一 般 步骤 如 下 (在 “项 目 ” 窗 口中 进行 )。 


(1) 单 击 选择 项 目 结 点 。 

(2) 从 “文件 "菜单, 选择“ 新建 文件 ”命令 ,打开 “新 建文 件 ” 对 话 框 。 
(3) 选择 文件 类 型 : JavaServer Faces|JSF 页 。 

(4) 指定 JSF 页 的 文件 名 (不 需要 指定 扩展 名 ) ,有 选择 地 指定 文件 夹 。 
(5) 单 击 “完成 ”按钮 。 


2.4.5 设置 上 下 文 路 径 


如 果 JSF 应 用 以 GlassFish 为 部 署 服务 器 . 则 其 上 下 文 路 径 可 在 自动 产生 的 sun-web. 
xml 文件 中 用 context-root 元 素 指定 。 


<context-root>/login</context-root> 


默认 情况 下 ,JSF 应 用 的 上 下 文 路 径 为 斜 杠 / 跟 应 用 项 目的 名 称 。 在 本 例 中 ,项 目 名 称 
为 ch2_login, 应 用 的 默认 上 下 文 路 径 为 /ch2_login。 在 此 ,把 上 下 文 路 径 改 为 /login。 


2.4.6 检查 部 署 描述 符 


在 NetBeans IDE 环境 下 创建 一 个 JSF 应 用 时 ,会 自动 产生 部 署 描述 符 web. xml 文件 。 
该 文件 位 于 WEB-INF 下 ,包含 着 若干 对 JSF 应 用 来 说 必要 或 有 用 的 元 素 。 
1. 上 下 文 参 数 指定 项 目 阶 段 


<context-param> 
<param- name>javax.faces.PROJECT STAGE< /param- name> 
<param-value>Development</param-value> 


</context-param> 


该 参数 指定 应 用 项 目 在 其 生命 周期 中 所 处 的 阶段 ,有 效 的 取 值 包括 Development、 
UnitTest、SystemTest 和 Production。 在 开发 阶段 (Development) ,JSF 框架 会 在 应 用 运行 
出 错时 给 用 户 提供 更 多 的 调试 信息 。 

2. servlet 元 素 和 相应 的 servlet-mapping 元 素 指 定 FacesServlet 


<servlet> 
<servlet-name>Faces Servlet</servlet-name> 
<servlet-class>javax.faces.webapp.FacesServlet</servlet-class> 
<load-on-startup>1</lo0ad-on- startup> 

</servlet> 

<servlet-mapping> 
<servlet-name>Faces Servlet</servlet-name> 
<url-pattern>/faces/*</url-pattern> 


</servlet-mapping> 


上 述 元 素 指定 了 FacesServlet 的 名 称 和 url 模式 。 上 默认 情 况 下 ,FacesServlet 的 url 模 
式 是 /faces/ * 。FacesServlet 是 JSF 框架 入 口 点 ,所 有 对 JSF 页 面 的 请 求 都 必须 通过 它 。 
所 以 如 果 访 问 JSF 页 login. xhtml, 不 能 简单 地 指定 URL 为 http://localhost:8080/login/ 
login. xhtml ,而 应 指定 为 http://localhost:8080/login/faces/login. xhtml。 

二 更 全 


3. welcome-file-list 元 素 指定 欢迎 页 面 


<welcome-file-list> 
<welcome-file>faces/login.xhtml</welcome- file> 


</welcome- file-list> 


欢迎 页 面 又 称 主 页 或 默认 页 面 ,通常 是 指 用 户 访 问 一 个 网 站 或 Web 应 用 (没有 指定 具 
体 页 面 ) 时 ,被 第 一 个 显示 的 页 面 。 

默认 情况 下 ,在 NetBeans IDE 下 创建 一 个 JSF 应 用 时 ,会 自动 创建 一 个 index. xhtml 
页 面 文件 , 且 指定 该 文件 为 欢迎 页 面 。 这 里 ,将 欢迎 页 面 改 为 登录 页 面 login. xhtml, 同 时 可 
以 将 index. xhtml 文件 删除 。 

要 删除 index. xhtml 文件 ,可 以 在 “项 目 ” 窗 口中 右 击 该 文件 结 点 ,然后 在 打开 的 快捷 菜 
单 中 选择 “删除 ”命令 。 

说 明 : 通常 ,如 果 没 有 指定 欢迎 页 面 , Web 服务 器 会 自动 把 保存 在 Web 应 用 文档 根 目 
录 下 的 index. html 文件 作为 默认 页 面 。 


2.4.7 运行 JSF 应 用 


如 果 登 录 应 用 是 主 项 目 (项 目 结 点 粗 体 显 示 ), 可 以 直接 按 F6 键 或 单 击 工具 栏 上 的 “ 运 
行 主 项 目 ” 按 钮 运行 该 项 目 。 如 果 hello 应 用 不 是 主 项 目 , 可 以 在 “项 目 ” 窗 口中 右 击 该 项 目 
结 点 ,然后 在 打开 的 快捷 菜单 中 选择 “运行 "命令 运行 该 项 目 。 

当 运 行 一 个 JSF 应 用 项 目 时 ,NetBeans IDE 将 完成 以 下 工作 。 

(1) 对 项 目 中 文件 的 任何 修改 ,自动 进行 保存 。 

(2) 将 JSF 应 用 重新 部 署 到 服务 器 。 如 果 服 务 器 还 没有 启动 , 则 先 启 动 服务 器 。 

(3) 通过 浏览 器 向 JSF 应 用 发 出 请 求 (http://localhost:8080/login/)。 如 果 浏 览 器 还 
没有 打开 , 则 先 打 开 浏 览 器 。 

登录 应 用 项 目 运 行 后 ,首先 显示 欢迎 页 面 , 即 登录 页 面 。 当 用 户 提交 登录 请 求 时 ,如 果 
用 户 名 和 密码 都 合法 ,将 显示 登录 成 功 页 面 ,否则 显示 登录 失败 页 面 。 


2:5 水 结 


。 JSF 是 一 种 基于 Java 的 Web 应 用 的 用 户 界面 软件 框架 ,提供 了 一 种 以 组 件 为 中 心 、 

事件 驱动 的 用 户 界面 构建 方法 。 

。 MVC 架构 将 软件 分 割 为 松 耦合 的 模型 .视图 、 控 制 器 3 个 部 分 ,各 部 分 各 司 其 职 。 
基于 JSF 框架 ,开发 人 员 可 以 很 好 地 遵循 MVC 设计 架构 开发 Web 应 用 。 

。 JSF 页 面 由 标记 组 成 ,每 个 标记 在 服务 器 端的 内 部 表示 成 一 个 组 件 实例 。 一 个 JSF 
页 面 的 所 有 标记 的 组 件 实例 组 成 一 棵 组 件 树 ,是 JSF 页 面 在 服务 器 端的 内 部 表示 。 

。 呈现 器 既 负责 从 服务 器 端 组 件 到 客户 端 响应 的 转换 ,也 负责 对 请 求 参 数 进行 解析 并 

保存 到 服务 器 端 特 定 的 组 件 内 。 

JSF 请 求 处 理 生命 周期 包括 恢复 视图 、 应 用 请 求 值 , 处 理 验证 、 更 新 模型 值 、 调 用 应 

用 和 呈现 响应 这 6 个 阶段 。 


交 济 风 放 


习 题 2 


1. 什么 是 JSF? 

2. 什么 是 MVC 设计 架构 ? MVC 设计 架构 有 何 优点 ? 

3. 术语 解释 : 

。 JSF 标记 、JSF 组 件 ; 

。 JSF 页 面 JSF 视图 ; 

。 呈现 器 ; 

。 JSF 组 件 标识 符 、JSF 组 件 客户 端 标识 符 。 

4. 简 述 JSF 请 求 处 理 生命 周期 。 

5. 创建 一 个 JSF 应 用 (sh2_palindrome) ,包含 index. xhtml 和 result. xhtml 两 个 JSF 
页 面 。index. xhtml 包含 一 个 表单 ,用户 可 以 输入 并 提交 一 个 字符 串 ,如 图 2-7 所 示 。 


sh2 palindrome 一 ozilla Firefox 


文件 四 编辑 E) 查看 历史 G) 书签 @) 工具 CD) 帮助 如 从 


- 用 -| 日 http://localhost:8080/sh2_palindrone/ |»| 加 | 


判断 一 个 字符 串 是 否 为 “ 回 文 ” 


请 输入 字符 帅 


图 2-7 第 5 题 示意 图 


当 用 户 提交 字符 串 后 ,JSF 应 用 将 判断 该 字符 串 是 否 为 * 回 文 ”, 然 后 转 result. xhtml 页 
显示 判断 结果 。result. xhtml 页 显示 的 内 容 包 括 用 户 输入 的 字符 串 以 及 判断 结果 :“ 是 回 
文 "或 “不 是 回 文 ”。 


。28。 


第 3 章 受 管 bean 与 EL 表达 式 


本 章 主题 : 

。 编写 bean 类 

。 配置 受 管 bean 

。 值 表 达 式 

。 方法 表达 式 

。 在 页 面 外 使 用 EL 表达 式 

所 谓 受 管 bean 是 指 受 JSF 框架 的 受 管 bean 工具 管理 的 JavaBean。 这 里 ,开发 人 员 除 
需 按 一 定 规范 编写 bean 类 外 ,还 需 对 受 管 bean 进行 相关 的 配置 声明 ,而 bean 实例 的 创建 
和 清除 则 由 受 管 bean 工具 根据 需要 自动 完成 。 

按 作用 分 , 受 管 bean 可 大 致 分 为 支撑 bean(backing bean) 和 模型 bean 两 大 类 。 支 撑 
bean 与 JSF 页 面相 关联 ,其 属性 往往 与 页 面 的 组 件 或 组 件 属 性 绑 定 在 一 起 。 模 型 bean 实 
现 应 用 的 业务 逻辑 。 在 Java EE 架构 中 ,业务 逻辑 通常 由 EJB 实现 ,但 在 中 小 型 的 JSF 应 
用 中 ,业务 逻辑 完全 可 以 由 受 管 bean 或 者 普通 的 Java 类 实现 。 本 书 介绍 的 应 用 示例 中 , 主 
要 用 受 管 bean 作为 页 面 的 支撑 bean, 用 普通 的 Java 类 实现 应 用 所 需 的 业务 逻辑 。 

EL(Expression Language) 技 术 源 于 JSP 中 的 表达 式 语 言 , 在 JSF 中 得 到 了 进一步 的 扩 
展 。EL 表达 式 通常 应 用 于 页 面 , 通 过 EL 表达 式 , 页 面 可 以 方便 地 访问 受 管 bean 属性 或 调 
用 受 管 bean 方 法。 在 JSF 中 ,EL 表达 式 具 有 举足轻重 的 作用 , 它 与 支撑 bean 一 起 共同 构 
筑 成 表示 层 与 业务 层 之 间 的 通信 桥梁 。 


3.1 编写 bean 类 


与 普通 的 JavaBean 类 一 样 , 受 管 bean 类 的 编写 也 需要 符合 一 定 的 规范 。 下 面 是 编写 
bean 类 的 一 个 基本 约定 : 

(1) 有 一 个 不 带 形 参 的 public 构造 方法 。 

(2) 提供 用 于 获取 和 /或 设置 属性 值 的 public 方法 。 这 些 方法 的 名 称 形 如 getXxx、 
setXxx, 其 中 Xxx 为 相应 的 属性 名 ,getter 方 法 的 返回 类 型 为 相应 属性 的 类 型 。 如 果 属 性 
类 型 为 boolean ,那么 方法 名 getXxx 也 可 用 isXxx 代替 。 

(3) bean 类 一 般 应 该 实现 java. io. Serializable 接口 , 即 bean 实例 应 该 是 可 序列 化 的 。 
尤其 是 作用 域 为 应 用 、 会 话 和 视图 的 受 管 bean ,将 其 声明 为 可 序列 化 的 ,可 便于 应 用 服务 器 
对 其 进行 有 效 管 理 。 

与 普通 的 Java 类 实例 由 new 表达 式 创建 不 同 ,bean 实例 通常 由 受 管 bean 工具 自动 创 
建 。 受 管 bean 工具 一 般 调 用 不 带 形 参 的 构造 方法 创建 bean 实例 ,因此 bean 类 必须 提供 该 
构造 方法 。 
属性 是 bean 的 一 个 基本 特性 。 工 具 通过 bean 类 提供 的 getter 方法 和 setter 方法 ,了 
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解 bean 所 具有 的 属性 ,以 及 实现 对 相应 属性 的 访问 。 一 个 提供 getter 方法 的 属性 被 认为 是 
可 读 的 ,一 个 提供 setter 方 法 的 属性 被 认为 是 可 写 的 。 

在 很 多 情况 下 ,一 个 属性 会 有 一 个 对 应 的 实例 变量 ,但 并 非 一 定 如 此 。 请 看 下 面 的 
bean 类 (代码 清单 3-1) 。 

代码 清单 3-1 受 管 bean 类 示例 (Circle. java) 


. Package bean; 


. import java.io.Serializable; 
. Public class Circle implements Serializable { 


public void setRadius (int r){ 
radius=r; 
} 


1 
多 
3 
4 
5. private int radius; 
6 
7 
8 
9 public int getRadius (){ 


10. return radius; 

11, } 

12. 

13. public double getArea(){ 

14. return Math.PI * radius * radius; 
15. } 

16. } 


该 bean 类 定义 了 一 个 名 为 radius 的 可 读 写 属性 ,以 及 一 个 名 为 area 的 只 读 属 性 。 这 
里 area 属性 并 没有 对 应 的 实例 变量 。 

当然 ,bean 类 也 是 一 种 Java 类 ,bean 实例 也 是 一 种 Java 对 象 。 可 以 在 bean 类 中 声明 
一 些 普 通 的 实例 方法 ,并 通过 bean 实例 调用 这 些 方法 。 


3.2 配置 受 管 bean 


JSF 受 管 bean 工具 负责 管理 受 管 bean, 包 括 受 管 bean 的 创建 .初始 化 清除 ,以 及 客户 
代码 对 受 管 bean 的 访问 。JSF 受 管 bean 工具 根据 配置 信息 管理 受 管 bean, 开 发 人 员 负 责 
声明 受 管 bean 的 配置 。 


3.2.1 声明 受 管 bean 


受 管 bean 的 配置 信息 如 下 。 

(1) bean 名 称 : 指 bean 实例 的 名 称 , 外 界 通过 该 名 称 访 问 指定 bean 的 属性 或 调用 指 
定 bean 的 方法 。 在 一 个 JSF 应 用 中 ,每 个 受 管 bean 的 名 称 应 该 是 唯一 的 。 

(2) bean 类 名 : 由 包 名 限制 的 完整 类 名 。 当 外 界 通过 bean 名 称 访 问 bean 时 ,如 果 
bean 不 存在 ,系统 将 自动 调用 该 bean 类 的 不 带 形 参 的 构造 方法 创建 一 个 bean 并 进行 初始 
化 ,然后 保存 在 指定 的 作用 域内 。 如 果 bean 已 经 存在 ,就 直接 使 用 它 。 

(3) 作用 域 : 指 bean 的 生存 期 限 。 受 管 bean 的 生存 期 限 包括 : 应 用 、 会 话 ` 视 图 .请 
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(4) 属性 初 值 : JSF 受 管 bean 工具 能 够 据 此 信息 对 受 管 bean 进行 初始 化 。 初 始 化 发 
生 于 bean 实例 创建 后 和 投入 使 用 之 前 。 

受 管 bean 的 配置 信息 有 两 种 声明 方式 : 一 是 在 bean 类 中 用 适当 的 Java 标注 
(annotation) 声 明 ; 二 是 在 JSF Faces 配置 文件 (XML 文件 ) 中 用 相应 的 元 素 声 明 。 

下 面 是 用 Java 标注 声明 受 管 bean 的 例子 。 


package bean; 


import java.io. Serializable; 


@ManagedBean (name="me") 
@RequestScoped 


public class UserBean implements Serializable { 


} 


标注 @ManagedBean 指明 它 所 标注 的 UserBean 类 是 一 个 bean 类 ,其 中 name 属性 指 
定 bean 的 名 称 为 me。 上 默认 情况 下 ,bean 的 名 称 与 类 名 一 致 , 且 第 一 个 字母 是 小 写 。 也 就 
是 说 ,在 该 例 中 如 果 @ ManagedBean 标注 没有 设置 name 属性 , 则 bean 的 名 称 将 为 
userBean 。 
标注 @RequestScoped 指明 受 管 bean 的 作用 域 为 请 求 。 各 作用 域 对 应 的 Java 标注 
如 下 : 
。 应 用 : @ApplicationScoped; 
。 会 话 : @SessionScoped; 
。 视图 : @ViewScoped; 
。 请 求 : @ RequestScoped; 
。 无 : @NoneScoped。 
下 面 是 在 JSF Faces 配置 文件 中 用 相应 元 素 声明 受 管 bean 的 例子 。 


<faces-config version="2.0"...... > 
<managed-bean> 
<managed-bean-name>me< /managed-bean-name> 
<managed-bean-class>bean.UserBean< /managed-bean- class> 
<managed-bean- scope>request</managed-bean- scope> 


</managed-bean> 


</faces-config> 


managed-bean 是 顶层 faces-config 元 素 的 子 元 素 。 每 个 managed-bean 元 素 声明 一 个 
受 管 bean。 其 中 ,managed-bean-name 子 元 素 指定 bean 名 称 ,managed-bean-class 子 元 素 
指定 bean 类 名 ,managed-bean-scope 子 元 素 指定 bean 的 作用 域 。 各 作用 域 对 应 的 取 值 
如 下 : 


。 应 用 : application; 
二 坊 丰 向 


。 会 话 : session; 

。 视图 : view; 

。 请 求 : request; 

。 无 : none。 

上 述 元 素 都 应 该 放置 在 JSF Faces 配置 文件 中 。 在 NetBeans IDE 中 ,创建 一 个 配置 文 
件 的 步骤 如 下 : 

@ 单 击 选择 项 目 结 点 。 

@ 从 “文件 "菜单 ,选择 “新 建文 件 " 命 令 , 打 开 “ 新 建文 件 ” 对 话 框 。 

@ 选择 文件 类 型 : JavaServer Faces1JSF Faces 配置 。 

@ 指定 文件 名 及 存放 位 置 ,然后 单 击 “完成 "按钮 。 

一 个 JSF 应 用 项 目 可 以 包含 多 个 配置 文件 ,但 最 常用 的 是 保存 在 WEB-INF 目录 下 的 
名 为 faces-config. xml 的 配置 文件 。 


3.2.2 受 管 bean 的 作用 域 


前 面 提 到 受 管 bean 的 作用 域 包括 应 用 、 会 话 、 视 图 ,请求 和 无 。 这 里 对 各 种 作用 域 的 含 
义 及 特点 进行 介绍 。 

1. 应 用 作用 域 

该 作用 域 的 受 管 bean 在 Web 应 用 的 整个 存活 期 间 可 用 ,被 该 应 用 的 所 有 客户 、 会 话 和 

Web 应 用 的 存活 期 始 于 应 用 被 部 署 到 应 用 服务 器 , 止 于 应 用 被 取消 部 署 。 应 用 作用 域 
的 受 管 bean 实例 通常 在 第 一 次 被 访问 时 创建 ,并 一 直 保持 活动 ,直到 Web 应 用 被 取消 部 
署 。 期 间 ,不同 的 客户 .会 话 和 请 求 通过 EL 表达 式 或 其 他 方式 访问 该 受 管 bean 时 ,访问 到 
的 都 是 同一 个 bean 实例 。 

一 个 Web 应 用 可 以 被 多 个 客户 并 发 访问 ,也 可 以 包含 多 个 会 话 。 当 需要 在 多 个 客户 或 
多 个 会 话 之 间 共享 信息 或 传递 信息 时 ,可 以 考虑 使 用 应 用 作用 域 的 受 管 bean。 

2. 会 话 作用 域 

该 作用 域 的 受 管 bean 在 会 话 的 存活 期 间 可 用 ,可 被 该 会 话 期 间 的 所 有 请 求 共享 。 

会 话 是 指 一 个 客户 对 一 个 Web 应 用 的 一 系列 请 求 。 这 一 系列 的 请 求 并 不 要 求 是 连续 
的 ,期 间 可 以 访问 其 他 的 Web 应 用 或 网 站 。 在 JSF 中 ,会 话 通常 始 于 客户 对 一 个 JSF 应 用 
的 第 一 次 访问 , 止 于 会 话 被 显 式 结 束 ( 调 用 HttpSession 对 象 的 invalidate 方法 ) ,会话 超时 
或 者 浏览 器 关闭 。 会 话 作用 域 受 管 bean 实例 通常 在 会 话 期 间 该 受 管 bean 第 一 次 被 访问 时 
创建 ,并 在 会 话 期 间 一 直 保持 活动 。 在 一 个 会 话 期 间 各 请 求 通过 EL 表达 式 访问 一 个 会 话 
作用 域 的 受 管 bean 时 ,访问 到 的 都 是 同一 个 bean 实例 。 会 话 结束 时 ,在 该 会 话 期 间 创建 的 
所 有 会 话 作 用 域 受 管 bean 实例 将 被 销毁 。 

因为 在 JSF 应 用 运行 期 间 , 可 以 有 多 个 会 话 同时 存在 .所 以 同一 个 会 话 作 用 域 的 受 管 
bean 类 就 可 能 有 多 个 bean 实例 同时 同 在 。 不 同 的 会 话 访问 不 同 的 bean 实例 。 

当 需 要 在 一 个 会 话 的 各 请 求 之 间 共 享 或 传递 信息 时 ,可 以 考虑 使 用 会 话 作 用 域 的 受 管 
bean。 例 如 ,一 次 网 上 购物 过 程 通常 是 一 个 会 话 ,每 次 请 求 会 将 一 些 商 品 放 人 购物 车 (通常 
是 List 对 象 或 Map 对 象 ) ,最 后 再 进行 结账 。 这 里 可 以 将 购物 车 保存 在 会 话 作 用 域 的 受 管 
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bean 中 。 

3. 视图 作用 域 

该 作用 域 的 受 管 bean 仅 在 当前 视图 内 可 用 。 在 JSF 中 ,JSF 页 面 又 称 为 视图 。 视 图 作 
用 域 始 于 对 一 个 新 的 JSF 页 面 的 请 求 处 理 、 或 者 导航 到 一 个 新 的 JSF 页 面 , 止 于 对 另 一 个 
JSF 页 面 的 请 求 处 理 、 或 者 导航 到 另 一 个 JSF 页 面 。 视 图 作用 域 受 管 bean 实例 在 视图 作用 
域 期 间 该 受 管 bean 第 一 次 被 访问 时 创建 ,并 在 该 作用 域 期 间 一 直 保 持 活动 。 在 视图 作用 域 
期 间 发 生 的 对 某 视 图 作用 域 的 受 管 bean 的 访问 ,访问 到 的 都 是 同一 个 bean 实例 。 视 图 作 
用 域 结束 时 ,该 作用 域 期 间 创 建 的 所 有 视图 作用 域 受 管 bean 实例 将 被 销毁 。 

对 典型 的 回 送 请 求 , 可 以 把 请 求 处 理 的 6 个 阶段 分 为 两 个 过 程 。 前 5 个 阶段 为 第 一 过 
程 , 处 理 请 求 参数 .调用 业务 逻辑 ;第 6 个 阶段 为 第 二 个 过 程 ,完成 呈现 响应 。 第 一 个 过 程 涉 
及 的 视图 称 为 源 视 图 ,通常 是 上 一 次 请 求 处 理 产 生 的 响应 视图 。 此 时 ,上 次 请 求 处理 的 第 二 
个 过 程 和 本 次 请 求 处 理 的 第 一 个 过 程 就 处 于 同一 个 视图 作用 域 。 第 二 个 过 程 涉 及 的 视图 称 
为 目标 视图 ,与 源 视图 可 能 相同 也 可 能 不 相同 ,取决 于 导航 结果 。 如 果 目 标 视图 与 源 视图 相 
同 , 则 当前 视图 作用 域 就 从 第 一 个 过 程 延 伸 到 第 二 个 过 程 .否则 ,当前 视图 作用 域 结束 ,新 的 
视图 作用 域 开始 。 

4. 请 求 作用 域 

该 作用 域 的 受 管 bean 在 请 求 处 理 期 间 有 效 , 它 始 于 JSF 框架 接收 一 个 客户 请 求 并 着 手 
处 理 , 终 于 处 理 产 生 的 响应 返回 客户 端 。 

请 求 作 用 域 受 管 bean 实例 在 请 求 作用 域 期 间 该 受 管 bean 第 一 次 被 访问 时 创建 ,并 在 
该 作用 域 期 间 一 直 保 持 活动 ,可 被 请 求 处 理 过 程 中 涉及 的 源 视图 和 目标 视图 共享 。 请 求 作 
用 域 结束 时 ,该 作用 域 期 间 创建 的 所 有 请 求 作 用 域 受 管 bean 实例 将 被 销毁 。 

5. 无 (none) 作 用 域 

作用 域 声明 为 none 的 受 管 bean 没有 特定 的 作用 域 。 当 通过 EL 表达 式 访问 此 种 受 管 
bean 时 ,JSF 受 管 bean 工具 负责 创建 bean 实例 并 返回 ,但 不 会 进一步 对 bean 实例 进行 维 
护 , 即 不 负责 bean 实例 的 保存 以 及 销毁 。 

JSF 受 管 bean 工具 本 身 并 不 支持 线程 安全 机 制 。 由 于 视图 作用 域 、 请 求 作用 域 和 无 作 
用 域 的 受 管 bean 通常 是 单线 程 的 ,所 以 能 够 确保 线程 安全 。 但 应 用 作用 域 和 会 话 作用 域 的 
受 管 bean 却 是 可 以 多 线程 的 ,例如 在 一 个 会 话 期 间 ,客户 可 以 同时 从 多 个 浏览 器 窗口 提交 
请 求 ,并 访问 同一 个 会 话 作 用 域 受 管 bean。 如 果 要 在 应 用 作用 域 和 会 话 作 用 域 的 受 管 bean 
中 保证 线程 安全 ,应 该 提供 锁 机 制 。 


3.2.3 视图 作用 域 受 管 bean 应 用 示例 


该 应 用 项 目 (ch3_viewscope) 主要 由 两 个 页 面 和 一 个 受 管 bean 组 成 。 项 目的 运行 效果 
如 图 3-1 所 示 。 
项 目 运行 时 ,欢迎 页 面 上 首先 显示 一 个 单词 集 , 以 及 一 个 文本 框 和 一 个 提交 按钮 。 用 户 
可 以 在 文本 框 中 输入 单词 集中 任意 一 个 单词 并 提交 。 如 果 用 户 输入 的 单词 正确 ,该 单词 会 
从 单词 集中 删除 。 当 单词 集中 所 有 单词 都 删除 后 ,项 目 显示 包含 一 个 “再 来 一 次 ”命令 按钮 
的 页 面 。 
Ca 


用 户 单 
另 
只 是 从 


ch3:viewscope_index — orilla Firefox 


文件 F) 编辑 下) 查看 W) 历史 G) 书签 中 工具 帮助 00 
<@ -BD -| 日 he:/1locaheosta0eo/ha vierscope/ 


单词 集 ， 


cat dog tiger rabbit panda monkey crocodile lion elephant 


输入 要 从 单词 集中 删除 的 单词 : 
[ 琵 ] 


全 


ch3:viewscope_index — 看 ozilla Firefox 


B http://1ocalhost:8080/ch3_viewscope/ faces/index. xhtnl;js' 


cat dog tiger rabbit panda crocodile lion elephant 


输入 要 从 单词 集中 贡 除 的 单词 
LE 


ch3:viewscope_next — ozilla Firefox 


文件 F) 编辑 人 FE) 查看 w) 历史 G) 书签 @) I 具 人 0 帮助 人 0 


@ [DB http /oemhost:o000/ ch vierscope/faces/index. xhtml 


图 3-1 应 用 ch3_viewscope 运行 效果 图 


受 管 bean 

本 应 用 仅 定 义 了 一 个 受 管 bean 类 ,文件 名 为 Index. java, 见 代码 清单 3-2。 一 方面 
受 管 bean 起 着 支撑 bean 的 作用 。 其 中 words 属性 保存 着 页 面 要 显示 的 单词 集 。 对 于 页 面 
来 说 ,这 是 一 个 只 读 属性 。parameter 属性 可 以 接收 和 保存 用 户 输入 的 单词 。action 方法 在 


击 “ 提 交 ” 按 钮 时 被 调用 ,方法 的 返回 的 结果 会 作为 导航 处 理 器 进行 导航 的 依据 。 
一 方面 ,该 受 管 bean 也 扮演 了 模型 bean 的 作用 。 该 应 用 涉及 的 业务 处 理 较 为 简单 ， 
一 个 单词 集中 去 除 一 个 单词 ,因此 没有 定义 单独 的 模型 类 或 模型 受 管 bean。 有 关 的 


数据 处 理 代码 直接 放置 在 了 该 受 管 bean 的 action 方法 中 。 
代码 清单 3-2” 受 管 bean(Index. java) 


虽 owamoumwwN 


. Package bean; 


. import java.io.Serializable; 
. import javax.faces .bean.ManagedBean; 


. import javax.faces .bean.ViewScoped; 


. GManagedBean 
. @ViewScoped 


. Public class Index implements Serializable { 


public Index(){ 


words="cat dog tiger rabbit panda monkey crocodile lion elephant "; 


15, 


private String words; 


16. public String getWords (){ 

Ey return words; 

18» 上 

19 

20. private String parameter; 

21. public void setParameter (String in){ 
22. parameter=in.trim()+" "7 

3 ' 

24. public String getParameter(){ 

25, return ""} 

26, } 

27, 

28. public String action(){ 

和 2s int n=parameter.length (); 

30; int l=words.length (); 

1s int s=words.indexOf (parameter); 
32 . if(sS!=-1)1{ 

335 if(stn>=1){ 

r words=words .substring(0,s); 
9s } else { 

6% words=words .substring(0,s)+words.substring(s+n); 
3 } 

38 . } 

39. if(words.length()==0){ 

40. return "next"; 

41. } 

42。 return null; 

43. } 

44. } 


标注 @ViewScoped 指明 这 是 一 个 视图 作用 域 的 受 管 bean。bean 实例 在 欢迎 页 面 第 一 
次 呈现 响应 时 创建 。 只 要 用 户 还 没有 从 单词 集中 去 除 所 有 的 单词 ,应 用 不 会 导航 到 第 二 个 
页 面 。 在 这 期 间 , 该 bean 实例 一 直 存在 。 

2. JSF 页 面 

该 应 用 包含 两 个 页 面 。index. xhtml 页 (代码 清单 3-3) 是 一 个 欢迎 页 面 。 该 页 面 通 过 
EL 表达 式 # {index. words} 显示 受 管 bean 的 words 属性 ,通过 EL 表达 式 # {index. 
parameter} 将 用 户 的 输入 保存 到 受 管 bean 的 parameter 属性 中 ,通过 EL 表达 式 # {index. 
action} 在 用 户 提 交 时 调用 受 管 bean 的 action 方法 。 

代码 清单 3-3 index. xhtml 


.<?xml version= '1.0' encoding='UTF-8' ?> 


1 

2. <!DOCTYPE html] PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 

3 "http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional .dtd"> 
4 


.<html xmlns="http://www.w3.0rg/1999/xhtml" 


。，35 。 


xmlns:h="http://java.sun.com/jsf/html"> 
6. <h:head> 
Be <title>ch3:viewscope index</title> 
8. </h:head> 
9. <h:body> 
10. <h:form> 
Ys 单词 集 : <br/> 
2 <h:outputText value="#{index.words}"/> 
13. <p/> 
14. 输入 要 从 单词 集中 删除 的 单词 : <br/> 
5。 <h:inputText value="# {index.parameter}"/> 
16. <h:commandButton value=" 提交 " action="#{index.action}"/> 
7, </h:form> 
18. </h:body> 
19. </html> 


next. xhtml 页 (代码 清单 3-4) 仅 包含 一 个 命令 按钮 , 单 击 该 按钮 将 重新 回 到 index. xhtml 
页 面 。 
代码 清单 3-4 next. xhtml 


1.<?xml version='1.0' encoding= 'UTF-8' ?> 
2. <!DOCTYPE html PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 
可 "http:/V/www.w3.org/TR/xhtml1/DTD/xhtm1l1-transitional.dtd"> 
4. <html xmlns="http://www.w3.0rg/1999/xhtml" 
Ss xmlns:h="http://java.sun.com/jsf/html"> 
6 <h:head> 
<title>ch3:viewscope next</title> 
8 </h:head> 
9. <h:body> 
10. <h:form> 
EE <h :commandButton value=" 再 来 一 次 " action="index"/> 
2， </h:form> 
13. </h:body> 
14. </html> 


当 用 户 从 单词 集中 去 除 掉 所 有 的 单词 后 ,应 用 将 从 欢迎 页 面 导 航 到 该 页 面 ,此 时 上 述 
bean 实例 被 销毁 。 当 用 户 从 该 页 面 回 到 欢迎 页 面 时 ,新 的 bean 实例 将 被 创建 。 


3.2.4 生命 周期 方法 
在 定义 受 管 bean 类 时 ,可 以 通过 相应 的 Java 标注 指定 受 管 bean 的 一 些 生命 周期 方法 : 


public class MyBean implements Serializable { 
Q@PostConstruct 


public void initialize(){ 


// 初 始 化 代码 


。 36 。 


@PreDestroy 
public void shutdown (){ 


// 关 闭 代码 
} 
’ 


标注 @PostConstruct 用 于 修饰 一 个 方法 ,该 方法 会 在 bean 实例 创建 之 后 被 自动 调用 。 
标注 @PreDestroy 用 于 修饰 一 个 方法 ,该 方法 会 在 bean 实例 销毁 之 前 被 自动 调用 。 

由 于 JSF 受 管 bean 工具 并 不 负责 无 Cnone) 作 用 域 受 管 bean 实例 的 保存 和 销毁 ,所 以 
对 这 种 类 型 的 受 管 bean, 标 注 @PreDestroy 没有 意义 。 


3.2.5 初始 化 受 管 bean 


JSF 受 管 bean 工具 会 在 需要 时 自动 创建 bean 实例 ,并 在 将 bean 实例 投入 使 用 之 前 根 
据 配 置信 息 初始 化 bean 实例 。 

1. 简单 的 属性 设置 

下 面 是 一 个 简单 的 属性 设置 示例 。 其 中 managed-property 是 managed-bean 元 素 的 可 
选 子 元 素 , 用 于 为 一 个 bean 的 一 个 元 素 设 置 初始 值 。property-name 是 managed-property 
元 素 的 必 选 子 元 素 , 指定 需要 设置 的 属性 的 名 称 。value 和 null-value 都 是 managed- 
property 元 素 的 子 元 素 , 前 者 可 以 为 属性 指定 一 个 简单 值 , 后 者 为 属性 指定 null 值 。 


<managed-bean> 


<managed- property> 
<property-name>name< /property-name> 
<value>louby</value> 

</managed-property> 

<managed-property> 
<property-name>pw< /property-name> 
<null-value/> 

</managed-property > 


</managed-bean> 

受 管 bean 工具 会 根据 属性 本 身 推定 属性 的 类 型 。 如 果 属 性 类 型 不 是 String ,那么 工具 
会 首先 将 值 转换 成 所 需 的 类 型 ,然后 再 设置 属性 。 

2. 初始 化 List 型 属性 

如 果 属 性 类 型 为 List, 那 么 可 以 使 用 list-entries 元 素 为 属性 设置 初 值 。 这 里 list- 
entries 元 素 是 managed-property 元 素 的 一 个 子 元 素 。 

list-entries 元 素 至 多 有 一 个 value-class 子 元 素 . 用 于 指定 要 添加 到 List 表 中 的 元 素 的 
数据 类 型 。list-entries 元 素 可 以 有 多 个 value 子 元 素 ,每 个 value 子 元 素 指 定 List 表 的 一 个 
元 素 。 下 面 例子 对 一 个 List 型 的 names 属性 设置 初 值 。 


<managed-bean> 


<managed-property> 


局 潭 员 六 


<property-name>names</property-name> 

<list-entries> 
<value-class>java.lang.String</value-class> 
<value>liu</value> 
<value>zhao</value> 
<value>wang</value> 

</list-entries> 

</managed-property > 


</managed-bean> 


说 明 : 

(1) 如 果 bean 实例 化 后 该 属性 已 经 指向 一 个 表 , 那 么 工具 只 是 将 所 列 元 素 值 按 序 添加 
到 表 原 有 值 的 后 面 。 如 果 bean 实例 化 后 该 属性 没有 值 ( 即 为 null 值 ) ,工具 将 创建 一 个 
ArrayList 表 , 并 将 所 列 元 素 值 按 序 添 加 到 表 中 ,然后 设置 该 属性 。 

(2) 默认 情况 下 ,工具 添加 到 表 中 的 元 素 都 是 java. lang. String 型 的 , 若 为 其 他 类 型 ,应 
该 用 value-class 元 素 指定 所 需 类 型 。 

3. 初始 化 Map 型 属性 

如 果 属 性 类 型 为 Map ,那么 可 以 使 用 map-entries 元 素 为 属性 设置 初 值 。 这 里 map- 
entries 是 managed-property 元 素 的 一 个 子 元 素 。 

map-entries 元 素 至 多 有 一 个 key-class 子 元 素 和 一 个 value-class 子 元 素 , 但 可 以 有 多 
个 map-entry 子 元 素 。 其 中 ,key-class 子 元 素 指定 键 的 数据 类 型 ,value-class 子 元 素 指定 值 
的 数据 类 型 。 每 个 map-entry 子 元 素 指定 一 个 键 一 值 对 ,其 key 子 元 素 指定 键 ,value 子 元 
素 指定 值 。 下 面 例子 为 一 个 Map 型 的 cart 属性 设置 初 值 。 


<managed-bean> 


<managed- property> 
<property-name>cart</property-name> 
<map-entries> 
<key-class>java.lang.String</key-class> 
<value-class>java.lang.Integer</value-class> 
<map-entry> 
<key>101</key> 
<value>1</value> 
</map-entry> 
<map-entry> 
<key>102< /key> 
<value>2</value> 
</map-entry> 
</map-entries> 
</managed-property > 


</managed-bean> 

说 明 : 

(1) 如 果 bean 实例 化 后 该 属性 已 经 指向 一 个 映射 ,那么 工具 只 是 将 所 列 键 一 值 对 添加 
we 


到 映射 中 。 如 果 bean 实例 化 后 该 属性 没有 值 ( 即 为 null 值 ) ,工具 将 创建 一 个 HashMap 映 
射 ,并 添加 所 列 的 键 一 值 对 ,然后 设置 该 属性 。 

(2) 默认 情况 下 ,工具 产生 的 键 和 值 都 是 java. lang. String 型 的 , 若 为 其 他 类 型 .应 该 用 
key-class 和 value-class 元 素 指定 所 需 的 类 型 。 


3.2.6 List 和 Map 型 受 管 bean 


表 (List) 或 映射 (Map) 既 可 以 作为 受 管 bean 的 属性 并 通过 配置 信息 进行 初始 化 ,也 可 
以 被 managed-bean 元 素 声明 为 受 管 bean 本 身 并 进行 初始 化 。 

当 用 managed-bean 元 素 声明 一 个 List 或 Map 型 的 受 管 bean 时 ,managed-bean-class 
子 元 素 必须 指定 实现 List 接口 或 Map 接口 的 一 个 具体 类 ,如 ArrayList、HashMap 等 。 
list-entries 和 map-entries 子 元 素 可 以 分 别 初始 化 该 List 或 Map 型 的 受 管 bean。 这 里 ， 
list-entries 和 map-entries 是 managed-bean 元 素 的 直接 子 元 素 。 

下 面 例子 声明 了 一 个 List 型 受 管 bean, 具 体 的 类 型 是 ArrayList ,初始 值 包含 3 个 元 
素 。 在 EL 表达 式 中 ,可 以 通过 bean 名 称 names 访问 该 List 型 受 管 bean。 


<managed-bean> 

<managed-bean-name>names</managed-bean-name> 
<managed-bean-class>java.util.ArrayList</managed-bean- class> 
<managed-bean- scope>application</managed-bean- scope> 
<list-entries> 

<value>liu</value> 

<value>zhao</value> 

<value>wang</value> 
</list-entries> 


</managed-bean> 


默认 情况 下 , 表 的 元 素 类 型 .映射 的 键 和 值 的 类 型 都 是 String。 若 需 其 他 类 型 ,应 该 在 
list-entries 或 map-entries 元 素 中 用 value-class 和 key-class 子 元 素 进行 指定 。 


3.2.7 初始 化 受 管 bean 应 用 示例 


该 应 用 项 目 (ch3_initializebean) 主 要 由 一 个 页 面 和 一 个 受 管 bean 组 成 。 项 目的 运行 效 
果 如 图 3-2 所 示 。 


initializebean — ozilla Firefox 


文件 四 编辑 E) 查看 W) 历史 G) 书签 如 工具 四) 天助 0 


9 -| 日 http://1ocalhost:8080/ch3_initislizebean/ 


相应 的 姓名 李 小 明 


完成 


图 3-2 应 用 ch3_initializebean 运行 效果 图 


Pe 


受 管 bean 包含 一 个 List 型 属性 ,存放 着 一 组 姓名 。 页 面 根 据 索引 值 显示 相应 的 姓名 ， 
其 中 索引 值 可 以 由 用 户 在 文本 域 中 指定 。 

1. 创建 配置 文件 

默认 情况 下 ,新 创建 的 JSF 应 用 项 目 不 包 含 JSF 配置 文件 。 在 NetBeans IDE 中 ,可 以 
按 下 列 步骤 创建 一 个 配置 文件 。 

(1) 单 击 选择 项 目 结 点 。 

(2) 从 “文件 ”菜单 ,选择 “新 建文 件 " 命 令 , 打 开 “ 新 建文 件 ” 对 话 框 。 

(3) 选择 文件 类 型 : JavaServer Faces|JSF Faces 配置 , 单 击 “ 下 一 步 ” 按 钮 。 

(4) 如 果 项 目 还 没有 包含 任何 Faces 配置 文件 ,那么 通常 应 该 默认 NetBeans 提供 的 文 
件 名 和 存放 位 置 , 即 文件 名 为 faces-config, 存 放 位 置 为 WEB-INF 目录 。 

(5) 最 后 单 击 “ 完 成 ”按钮 。 

本 应 用 中 ,首先 按 上 述 步骤 创建 配置 文件 WEB-INF\faces-config. xml。 

2. 创建 受 管 bean 

本 应 用 仅 包含 一 个 受 管 bean( 代 码 清单 3-5) ,其 配置 信息 不 采用 Java 标注 形式 声明 ,而 
是 放置 在 配置 文件 中 。 

用 NetBeans IDE 中 的 命令 新 建 一 个 受 管 bean 时 , 若 在 “名 称 和 位 置 ? 对 话 框 中 选择 “向 
配置 文件 添加 数据 ? 复 选 框 ,那么 有 关 该 受 管 bean 的 类 名 .bean 名 称 和 作用 域 等 配置 信息 
就 不 会 以 Java 标注 形式 出 现在 bean 类 中 ,而 是 出 现在 指定 的 配置 文件 中 。 

这 里 ,将 受 管 bean 的 类 名 设置 为 bean. NameList( 其 中 bean 是 包 名 ) ,bean 名 称 设置 为 
namesybean 的 作用 域 设置 为 request。 

代码 清单 3-5 NameList. java 


. Package bean; 


. import java.util.List; 


时 

2 

3 

4. public class NameList { 
3 

6 public NameList(){ 

} 

8 


9 。 private int index; 


10. public int getIndex(){ 


11。 return index; 

12。 } 

3 public void setIndex (int index){ 
14。 this.index=index; 

15, 3 

16. 

17. private List<String>list; 


18. public void setList (List<String>1list)t{ 
LE this.list=list; 
20， } 


21s 

22. private String element; 

23. Ppublic String getElement (){ 
24. return list.get (index); 
25, 本 

26. 


该 受 管 bean 包含 一 个 可 读 写 的 index 属性 ,一 个 可 写 的 list 属性 ,以 及 一 个 可 读 的 
element 属性 。 

3. 配置 受 管 bean 

配置 文件 faces-config. xml 中 有 关 受 管 bean 的 声明 和 配置 信息 如 代码 清单 3-6 所 示 。 
其 中 , 受 管 bean 的 类 名 、bean 名称 及 作用 域 等 信息 在 创建 受 管 bean 时 自动 添加 ,而 受 管 
bean 的 初始 化 信息 由 手工 编制 完成 。 

这 里 ,names 受 管 bean 的 index 属性 值 初始 化 为 0,list 属性 初始 化 后 包含 4 个 元 素 
(姓名 ) 。 

代码 清单 3-6 faces-config. xml 


1. <managed-bean> 
2 <managed-bean-name>names</managed-bean-name> 
3 <managed-bean-class>bean.NameList</managed-bean-class> 
4. <managed-bean-scope>request</managed-bean-scope> 
5. <managed-property> 
6 <property-name>index</property-name> 
时 <value>0< /value> 
8 </managed-property> 
9. <managed-property> 
10. <property-name>list</property-name> 
11。 <list-entries> 
125 <value> 李 小 明 < /value> 
二 <value> 刘 宇 翔 </value> 
14. <value> 胡 刚 < /value> 
5 <value> 赵 日 杰 < /value> 
16. </list-entries> 


17. </managed-property> 


18. </managed-bean> 


4. JSF 页 面 

本 应 用 只 有 一 个 页 面 ( 代 码 清 单 3-7) ,其 中 inputText 组 件 标 记 的 value 属性 与 bean 的 
可 读 写 属性 index 绑 定 在 一 起 ,outputText 组 件 标 记 的 value 属性 与 bean 的 可 读 属性 
element 绑 定 在 一 起 。 

代码 清单 3-7 index. xhtml 


1. <?xml version='1.0' encoding= 'UTE-8' ?> 
2. <!DOCTYPE html PUBLIC "- //W3C/V/DTD XHTML 1.0 Transitional//EN" 
3. "http://www.-w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
。41 。 


4. <html xmlns="http://www.w3.0rg/1999/xhtml" 
s xmlns:h="http://java.sun.com/jsf/html"> 
6 <h:head> 
<title>initializebean</title> 
8 </h:head> 
9 <h:body> 
10。 <h:form> 
yy <h:outputLabel id="11l" for="il" value=" 输 入 索引 值 "/> 
12. <h:inputText id="il" value="# {names.index}"/> 
13， <p></p> 
14. <h:commandButton id="cl" value=" 确 定 "/> 
15. <p></p> 
i <h:outputText id="ol" value=" 相 应 的 姓名 #{names.element}"/> 
17, </h:form> 
18. </h:body> 
19. </html> 


这 里 ,请 求 参 数 总 是 字符 串 型 ,而 它 需 要 设置 的 index 属性 类 型 为 int 型 。 此 时 ,JSF 框 
架 会 自行 完成 类 型 转换 。 


3.3 值 表 达 式 


在 JSF 中 ,EL(Expression Language) 表 达 式 是 页 面 与 受 管 bean 之 间 联 系 的 纽带 。 

EL 表达 式 的 语法 格式 是 # {expr} ,可 分 为 值 表达 式 和 方法 表达 式 。 通 过 EL 值 表达 
式 ,JSF 页 面 可 以 访问 bean 的 属性 。 通 过 EL 方法 表达 式 ,JSF 页 面 能 够 调用 bean 的 方法 。 
本 节 介 绍 值 表 达 式 ,第 3.4 节 介绍 方法 表达 式 。 


3.3.1 值 表达 式 的 基本 用 法 
值 表 达 式 一 般 出 现在 页 面 中 ,用 于 访问 bean 的 属性 。 假 如 页 面 中 有 如 下 JSF 标记 : 


<h:inputText value="# {user.name}"/> 


在 该 标记 被 呈现 时 ,表达 式 user. name 将 以 右 值 模式 被 计算 : user 的 getrName 方法 被 调 
用 ,name 属性 值 被 读 取 以 便 显示 。 在 页 面 提交 时 ,表达 式 user. name 将 以 左 值 模式 被 计算 ， 
user 的 setName 方法 被 调用 ,name 属性 被 设置 为 用 户 输入 的 值 。 

这 里 ,运算 符 “. ”用 于 访问 bean 的 属性 或 调用 bean 的 方法 。 在 EL 表达 式 中 ,运算 符 
“.” 和 “[] ?通常 可 以 互相 替换 使 用 ,或 同时 混合 使 用 。 下 面 表达 式 是 等 价 的 : 

es USer. namey; 

。 user["name" |]; 

。 user['name']。 


相应 地 ,上 面 的 JSF 标记 可 以 写成 如 下 : 


<h:inputText value='#{user["name"]}'/> 


避 如 站 才 


<h:inputText value="#{user['name']}"/> 


实际 上 , 相 比 运算 符 “.”, 运 算 符 “[]” 更 加 通用 化 。 比 如 上 面 访问 name 属性 的 表达 式 ， 
也 可 以 采用 格式 user[sub_expr]。 这 里 ,sub_expr 是 一 个 子 表 达 式 ,只 要 它 的 计算 结果 为 
字符 串 “name” 即 可 。 


3.3.2 访问 表 、 映 射 和 数组 


值 表 达 式 不 仅 可 以 访问 受 管 bean 的 简单 属性 ,也 可 以 访问 表 (List)、 映 射 (Map) 或 者 
数组 等 属性 或 对 象 的 元 素 。 

假设 + 是 一 个 List 型 对 象 , 则 可 以 用 表达 式 t[ 澡 访问 索引 值 为 i 的 表 元 素 : 

。 在 右 值 模式 下 ,方法 t. get(i) 被 调用 ,相应 的 值 返 回 。 

。 在 左 值 模式 下 ,方法 t. set(i, value) 被 调用 ,相应 的 值 (value) 被 写 人 表 中 。 

假设 a 是 一 个 数组 对 象 , 则 可 以 用 表达 式 a[ 训 访问 索引 值 为 i 的 数组 元 素 : 

。 在 右 值 模式 下 ,元素 a[ 让 被 访问 ,相应 的 值 返 回 。 

。 在 左 值 模式 下 ,元素 a[ 让 被 访问 ,相应 的 值 被 写 入 数组 中 。 

在 上 面 访问 表 元 素 或 数组 元 素 的 表达 式 中 ,i 一般 应 为 整数 或 能 够 转换 成 整数 的 字符 
串 , 如 tL3],\aL"3"]。 更 一 般 地 ,索引 值 也 可 通过 子 表达 式 获得 。 比 如 ,n 是 名 为 me 的 受 管 
bean 的 一 个 int 型 属性 , 则 可 以 用 表达 式 aLuser. nj 访问 数组 a 的 一 个 元 素 。 

假设 m 是 一 个 Map 型 对 象 , 则 可 以 用 表达 式 m["key"j( 或 mL'key"]、m. key) 访 问 映 射 
中 键 为 字符 串 "key" 的 对 应 值 : 

。 在 右 值 模式 下 ,方法 m. get("key") 被 调用 ,相应 的 值 返回 。 

。 在 左 值 模式 下 ,方法 m. put("key", value) 被 调用 ,相应 的 值 (value) 被 写 入 映射 中 。 

如 果 要 访问 的 键 一 值 对 的 键 预先 未 知 ,或 者 键 的 类 型 不 是 String, 则 可 用 更 加 一 般 化 的 
格式 mLsub_exprj] 来 访问 , 即 键 由 其 中 的 子 表 达 式 计算 获得 。 


3.3.3 预定 义 对 象 及 初始 项 解析 
在 值 表达 式 中 ,可 以 访问 系统 预定 义 的 对 象 。 表 3-1 列 出 了 访问 这 些 预定 义 对 象 的 


表 3-1 在 EL 表达 式 中 可 用 的 预定 义 对 象 


变 量 名 含义 
header 包含 HTTP 请 求 头 中 各 域 的 映射 ,每 个 域 仅 包含 1 个 值 
headerValues 包含 HTTP 请 求 头 中 各 域 的 映射 ,每 个 域 对 应 一 个 String[ ] 数 组 
param 包含 HTTP 请 求 参 数 的 映射 ,每 个 请 求 参 数 仅 包含 1 个 值 
paramValues 包含 HTTP 请 求 参 数 的 映射 ,每 个 请 求 参 数 对 应 一 个 String[ ] 数 组 
cookie 包含 当前 请 求 的 Cookie 名 称 一 值 对 的 映射 
initParam 包含 该 Web 应 用 初始 化 参数 的 映射 


a 


续 表 


变 量 名 含 祷 
requestScope 包含 所 有 请 求 作用 域 bean 或 对 象 的 映射 
viewScope 包含 所 有 视图 作用 域 bean 或 对 象 的 映射 
sessionScope 包含 所 有 会 话 作用 域 bean 或 对 象 的 映射 
applicationScope 包含 所 有 应 用 作用 域 bean 或 对 象 的 映射 
flash 包含 要 转发 到 下 一 个 视图 的 对 象 的 映射 
resource 包含 应 用 程序 资源 的 映射 
facesContext 该 请 求 的 FacesContext 实例 对 象 
view 该 请 求 的 UIViewRoot 实例 对 象 
component 当前 组 件 
cc 当前 组 合 组 件 


例如 ,表达 式 header["User-Agent"] 可 以 返回 请 求 头 中 名 为 User-Agent 的 域 的 值 , 即 
用 户 浏览 器 的 类 型 。 

对 于 值 表 达 式 a.b,JSF 一 般 会 按 以 下 步骤 解析 初始 项 a: 

(1) 是 否 是 一 个 预定 义 对 象 ; 

(2) 依次 从 请 求 , 视 图、 会话 和 应 用 作用 域 的 映射 中 寻找 ; 

(3) 根据 配置 文件 (典型 为 faces-config. xml) 中 的 相关 信息 或 Bean 类 中 的 Java 标注 信 
息 ,寻找 是 否 存 在 指定 名 称 的 受 管 Bean。 若 存在 ,调用 该 Bean 类 默认 的 构造 方法 创建 bean 
实例 ,并 添加 至 相应 作用 域 的 映射 中 ,然后 返回 该 对 象 。 

下 面 举例 说 明 ,假设 JSF 应 用 中 定义 了 一 个 名 称 为 user 的 请 求 作用 域 的 受 管 bean, 其 
中 包含 一 个 name 属性 。 

先 考虑 表达 式 user. name。 因 为 user 不 是 一 个 系统 预定 义 对 象 ,所 以 JSF 将 依次 从 下 
面 映射 中 寻找 键 为 user 的 值 , 即 bean 实例 : 

。 请 求 作 用 域 映 射 (requestScope); 

。 视图 作用 域 映 射 (viewScope); 

。 会 话 作 用 域 映 射 (sessionScope) ; 

。 应 用 作用 域 映 射 CapplicationScope) 。 

如 果 这 是 作用 域内 对 该 受 管 bean 的 第 一 次 访问 ,那么 这 些 映 射 中 就 不 会 存在 所 需 的 
bean 实例 。 此 时 JSF 将 根据 配置 文件 信息 和 Java 标注 信息 ,定位 bean 类 并 创建 bean 实 
例 。 由 于 这 是 一 个 请 求 作用 域 的 受 管 bean, 因 此 创建 的 bean 实例 将 作为 属性 保存 在 请 求 
作用 域 映 射 CrequestScope) 中 。 

如 果 这 不 是 作用 域内 对 该 受 管 bean 的 第 一 次 访问 ,那么 JSF 将 会 在 请 求 作 用 域 映射 
(requestScope) 中 找到 所 需 的 bean 实例 。 

再 来 考虑 表达 式 requestScope. user. name。 因 为 requestScope 是 一 个 系统 预定 义 对 
象 , 即 请 求 作用 域 映 射 , 所 以 JSF 将 在 该 映射 中 寻找 键 为 user 的 值 , 即 bean 实例 。 如 果 之 
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前 在 作用 域内 已 经 访问 过 该 受 管 bean, 那 么 bean 实例 就 已 经 存在 。 此 时 表达 式 将 返回 该 
bean 的 name 属性 值 。 如 果 之 前 在 作用 域内 还 没有 访问 过 该 受 管 bean, 那 么 该 表达 式 不 会 
返回 任何 结果 。 


3.3.4 文字 与 运算 符 


在 值 表达 式 中 ,除了 能 够 访问 bean 实例 、 预 定义 对 象 数 组 、 表 和 映射 及 其 属性 和 元 素 
外 ,还 可 以 包含 文字 和 运算 符 , 实 现 基本 的 运算 处 理 。 

根据 不 同 的 场合 ,EL 值 表达 式 既 可 能 以 右 值 模式 处 理 , 也 可 能 以 左 值 模式 处 理 。 但 包 
含 文字 和 运算 符 的 值 表达 式 只 能 以 右 值 模式 处 理 。 

在 值 表达 式 中 可 以 使 用 以 下 类 型 的 文字 。 

。 布尔 值 : true 和 false; 

。 整数 : 如 12、128; 

。 浮 点 数 : 如 12.6、.5.、1.2e6、12E 一 3; 

。 字符 串 : 由 单 引 号 或 双 引 号 括 起 来 的 一 串 字符 ,如 "computer" Liming'; 

。 空 值 : null, 表 示 空 的 或 不 存在 的 引用 。 

在 值 表 达 式 中 可 以 使 用 的 运算 符 如 表 3-2 所 示 。 这 些 运 算 符 与 Java 语言 中 的 运算 符 大 致 
相同 ,但 其 中 有 些 运 算 符 还 可 以 用 英文 字母 来 表示 。 比 如 ,人 逻辑 非 既 可 以 用 “1”, 也 可 以 用 not。 

表 3-2 EL 运算 符 


分 类 运 算 符 优 先 级 
访问 运算 符 [ls 1 
小 括号 (3 2 
单 日 运算 符 一 、!Cnot) .empty 3 

* /(div) .% (mod) 并 
算术 运算 符 

= 5 

< 一 (ID <= >>=(ge) 6 
关系 运算 符 

二 一 (eq)、! 一 (Cne) 7 

&R&Cand) 8 
逻辑 运算 符 

| (Cor) 9 
条 件 运算 符 ? : 10 


单 日 运算 符 都 是 前 级 运算 符 , 比 如 empty a。 运 算 符 empty 用 于 判断 运算 对 象 是 否 为 
null, 或 是 否 为 空 串 ,或 是 否 为 不 包含 元 素 的 数组 、 集 合 或 映射 。 

要 注意 null 与 empty 之 间 的 区 别 。 考 虑 表达 式 user. name 王 二 null, 只 有 name 属性 值 
为 null 时 ,表达 式 的 值 才 为 true, 其 他 情况 表达 式 的 值 都 为 false。 而 对 于 表达 式 empty 
user. name, 如 果 name 属性 值 为 null 或 空 串 ,表达 式 的 值 都 将 为 true。 

在 JSF 中 ,EL 表达 式 的 主要 作用 是 在 应 用 的 表示 层 和 业务 层 之 间架 起 了 一 座 桥梁 , 实 
现 了 表示 人 逻辑 和 业务 逻辑 的 分 离 。 在 EL 表达 式 中 进行 一 些 运算 , 主要 是 为 了 实现 表示 逮 
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辑 , 而 不 应 该 去 完成 涉及 业务 逻辑 的 复杂 的 数据 处 理 。 例 如 ,下 面 两 个 组 件 标记 根据 bean 
中 xb 属性 值 决定 是 否 呈 现 响应 ,其 中 只 能 有 一 个 组 件 标记 被 呈现 响应 


<h:outputText value=" 男 " rendered="#{user.xb=='1'}" ... /> 


<h:outputText value=" 女 " rendered="# {user.xb!="'1'}" ... /> 


3.3.5 复合 表达 式 
若干 值 表 达 式 (包括 静态 文本 ) 可 以 先后 放置 组 成 复合 表达 式 ,例如 ; 


<h:outputText value=" 姓 名 : #{fuser.namej, 年 龄 : #{user.age}"/> 


这 里 ,各 值 表达 式 依 其 出 现 的 先后 次 序 ,从 左 到 右 依 次 计算 并 转换 成 字符 串 ,然后 和 静态 文 
本 一 起 连接 形成 一 个 结果 字符 串 。 上 面 标 记 的 呈现 结果 形 如 : 姓名 : 李 明 ,年 龄 ,25。 
一 般 来 说 ,复合 表达 式 只 能 以 右 值 模式 处 理 。 


3.4 方法 表达 式 


方法 表达 式 涉及 一 个 对 象 及 其 一 个 public 方法 ,其 语法 与 值 表达 式 类 似 。 下 面 是 使 用 
方法 表达 式 的 一 个 例子 。 


<h:commandButton action="#{user.checkPassword}"/> 


假定 user 代表 某 受 管 bean 实例 ,checkPassword 是 它 的 一 个 public 方法 。 方 法 表达 式 
会 在 某 个 适当 时 机 计算 ,其 效果 是 调用 对 象 的 指定 方法 。 

在 JSF 中 ,一 个 组 件 标 记 在 服务 器 端 被 表示 为 一 个 组 件 对 象 。 用 户 的 操作 会 抽象 成 组 
件 对 象 的 事件 。 通 过 为 组 件 标 记 的 特定 属性 设置 方法 表达 式 , 可 以 为 组 件 对 象 的 特定 事件 
设置 事件 处 理 代码 。 例 如 ,可 以 为 命令 按钮 标记 的 action 属性 设置 一 个 方法 表达 式 , 当 用 户 
单 击 命令 按钮 提交 一 个 请 求 到 服务 器 时 ,该 方法 表达 式 将 被 计算 ,相应 的 方法 将 被 调用 。 

有 四 个 组 件 属 性 与 组 件 的 特定 事件 相关 联 , 经 常 需要 设置 方法 表达 式 。 

。 action( 看 第 4.6 节 ); 

。 validator( 看 第 4.3 节 、 第 7.5 节 ); 

。 actionListener( 看 第 4.6 节 、 第 8.2 节 ); 

。 valueChangeListener( 看 第 8. 3 节 ) 。 

由 于 这 些 属性 设置 的 方法 表达 式 用 于 处 理 不 同 的 事件 ,所 以 相应 方法 的 签名 会 有 各 自 
的 特点 。 方 法 的 参数 和 返回 类 型 取决 于 使 用 方法 表达 式 的 上 下 文 。 比 如 ,action 属性 绑 定 
的 方法 通常 要 求 无 形 参 .返回 类 型 为 String。 


Public String method name () 


又 比如 ,actionListener 属性 绑 定 的 方法 通常 需要 有 一 个 ActionEvent 型 参数 ,返回 类 
型 为 void。 


public void method _ name (ActionEvent e) 


这 里 ,开发 人 员 应 按 上 述 约定 声明 对 象 方法 ,而 EL 表达 式 工具 以 及 JSF 框架 将 负责 提供 参 
。46 。 


数 以 及 处 理 返回 值 。 
Java EE 6 平台 采用 EL 2. 2 版 本 ,支持 带 参数 的 方法 调用 。 


< 表达 式 > .< 标识 符 > (<parameters>) 


从 语法 格式 上 看 , 带 参 数 的 方法 表达 式 相 比值 表达 式 和 普通 的 方法 表达 式 ,多 了 一 个 参 
数列 表 。 其 中 ,二 表达 式 二 的 计算 结果 应 该 是 一 个 bean 实例 ;二 标识 符 二 代表 bean 实例 的 
一 个 方法 :到 参数 列表 之 由 逗号 分 隔 的 多 个 值 或 表达 式 组 成 。 

带 参数 的 方法 表达 式 不 见得 一 定 要 有 参数 ,但 一 对 圆 括号 不 能 省 略 ,这 是 它 与 传统 的 方 
法 表达 式 的 区 别 。 

假设 名 为 index 的 bean 有 如 下 方法 : 


public String move (int amount){...} 
那么 命令 按钮 的 action 属性 也 可 设置 成 如 下 : 


<h:commandButton value="Previous" action="#{index.move(-1)}"/> 


<h:commandButton value="Next" action="#{index.move(1)}"/> 
这 里 ,方法 重 载 并 不 被 支持 。 也 就 是 说 ,对 于 方法 表达 式 调用 的 方法 ,在 相应 的 bean 中 只 能 
有 一 个 有 此 方法 名 的 方法 。 

带 参 数 的 方法 表达 式 不 仅 可 以 出 现在 需要 方法 表达 式 的 属性 中 ,也 可 以 出 现在 值 表达 
式 可 以 出 现 的 地 方 。 当 带 参数 的 方法 表达 式 作 为 值 表达 式 使 用 时 , 它 只 能 以 右 值 模式 计算 。 


3.5 在 页 面 外 使 用 EL 表达 式 
大 多 数 情况 下 ,EL 表达 式 出 现在 页 面 中 。 页 面 通过 EL 表达 式 访问 受 管 bean, 实现 
JSF 应 用 的 表示 层 和 业务 层 之 间 的 联系 。 但 有 些 情况 下 ,也 需要 在 Faces 配置 文件 ,Java 类 
中 使 用 EL 表达 式 。 
3. 5. 1 通过 EL 表达 式 初始 化 受 管 bean 


可 以 在 Faces 配置 文件 中 使 用 EL 表达 式 来 初始 化 受 管 bean, 即 可 以 用 EL 表达 式 为 受 
管 bean 属性 设置 初 值 。 这 使 得 一 个 受 管 bean 可 以 通过 引用 其 他 受 管 bean 来 初始 化 自身 。 
这 种 引用 要 受到 受 管 bean 作用 域 的 约束 。 总 体 原则 是 ,一 个 受 管 bean 不 能 引用 生命 
周期 比 自己 短 的 受 管 bean, 具 体 约束 情况 如 表 3-3 所 示 。 
表 3-3 受 管 bean 之 间 的 引用 受 其 作用 域 约束 
被 引用 bean 的 作用 域 


引用 bean 的 作用 域 


none none 
application none 和 application 

session none session 和 application 

View none view、session 和 application 

request none requesrt\view session 和 application 
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这 里 ,作用 域 为 none 的 受 管 bean 可 以 被 任何 作用 域 的 受 管 bean 引用 ,但 其 本 身 只 能 
引用 作用 域 也 为 none 的 其 他 受 管 bean。 


3.5.2 EL 表达 式 初始 化 受 管 bean 应 用 示例 


该 应 用 项 目 (ch3_initializewithel) 主要 由 一 个 页 面 和 两 个 受 管 bean 组 成 。 项 目的 运行 
效果 如 图 3-3 所 示 。 


ch3_initializewithel_index — ozilla Firefox 


文件 FE) 编辑 EE) 查看 VY) 历史 G) 书签 @) 工具 中 帮助 0 


-本 -| 日 htp://loeahost-a0so/cha_initiaizeithal/ 


圆心 坐标 ，(10, 10) 
圆 的 半径 ，10 
输入 新 的 半径 | 


图 3-3 应 用 ch3_initializewithel 运行 效果 图 


两 个 受 管 bean 包含 一 个 圆 区 域 的 状态 数据 。 页 面 显 示 该 圆 区 域 的 状态 ,包括 圆心 的 x 

y 坐 标 值 ,以 及 圆 的 半径 。 其 中 的 圆 的 半径 可 以 由 用 户 修 改 。 
.创建 配置 文件 

To 新 创建 的 JSF 应 用 项 目 不 包 含 Faces 配置 文件 。 本 应 用 中 ,首先 创建 配置 
文件 WEB-INF\faces-config. xml。 

2. 创建 受 管 bean 

本 应 用 包含 两 个 受 管 bean: Circle. java 和 R_Circle. java。 受 管 bean 的 配置 信息 不 采 
用 Java 标注 形式 声明 ,而 是 放置 在 配置 文件 中 。 表 3-4 是 两 个 受 管 bean 的 基本 配置 信息 。 


表 3-4 应 用 ch3_initializewithel 中 受 管 bean 的 基本 配置 


bean. Circle circle request 


bean. R_Circle re session 


Circle 类 表示 圆 ,每 个 圆 对 象 有 一 个 radius 属性 .表示 圆 的 半径 。R_Circle 类 表示 圆 区 
域 , 每 个 圆 区 域 有 3 个 属性 : x 表示 圆心 的 横 坐 标 ,y 表示 圆心 的 纵 坐标 ,c 表示 圆 对 象 。 
Circle 类 的 定义 参看 本 章 一 开始 的 代码 清单 3-1,R_Circle 类 的 定义 如 代码 清单 3-8。 

代码 清单 3-8 R_Circle. java 


. Package bean; 


EE 

2. import java.io.Serializable; 

3。 

4. public class R Circle implements Serializable { 
5 
6 private int x; 
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22. 
235 
24. 
25. 
26 . 
27。 
28 . 
29, 


public int getx(){ 
return x; 

} 

public void setX(int x){ 


this .x=x; 


private int y; 

public int getY (){ 
return y; 

} 

public void setY(int y){ 
this.y=y; 


private Circle c; 

public Circle getC(){ 
return c; 

} 

public void setC(Circle c){ 


this.c=c; 


} 


3. 配置 受 管 bean 

配置 文件 faces-config. xml 中 有 关 受 管 bean 的 配置 信息 如 代码 清单 3-9 所 示 。 其 中 ， 
受 管 bean 的 类 名 ,bean 名 称 及 作用 域 等 信息 在 创建 受 管 bean 时 自动 添加 ,而 受 管 bean 的 
初始 化 信息 由 手工 编制 完成 。 

这 里 ,circle 受 管 bean 的 radius 属性 值 初始 化 为 10, 而 rc 受 管 bean 的 各 属性 则 通过 
EL 表达 式 初 始 化 。 其 中 ,x 和 y 都 设置 为 circle 受 管 bean 的 radius 属性 值 ,c 就 设置 为 
circle 受 管 bean 本 身 。 

代码 清单 3-9 faces-config. xml 


1. <managed-bean> 


ownamouwmw wm 


10. 
和 
2 
3, 
14. 


<managed-bean-name>rc</managed-bean-name> 

<managed-bean-class>bean.R Circle</managed-bean-class> 

<managed-bean-scope>request</managed-bean- scope> 

<managed-property> 
<property-name>x</property-name> 
<value>#{circle.radius}</value> 

</managed-property> 

<managed-property> 
<property-name>y</property-name> 
<value>#{circle.radius}</value> 

</managed-property> 

<managed-property> 


<property-name>c</property-name> 
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5 
0s 


玉生 


4. 


<value>#{circle}</value> 


</managed-property> 


.</managed-bean> 
18 . 
9， 
20， 
21。 
22。 
23。 
24. 
25。 
26。 


<managed-bean> 

<managed-bean-name>circle</managed-bean-name> 

<managed-bean-class>bean.Circle</managed-bean-class> 

<managed-bean-scope>session</managed-bean-scope> 

<managed-property> 
<property-name>radius</property-name> 
<value>10</value> 

</managed-property> 


</managed-bean> 


JSF 页 面 


本 应 用 仅 有 一 个 页 面 (代码 清单 3-10) , 它 首先 显示 rc 受 管 bean( 圆 区 域 ) 的 的 圆心 坐标 
及 圆 半径 ,然后 提供 一 个 表单 ,该 表单 可 以 重新 设置 circle 受 管 bean( 圆 ) 的 半径 。 
代码 清单 3-10 index. xhtml 


17。 
18 . 


.<?xXml Version='1.0' encoding= 'UTE-8' ?> 
.<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1l/DTD/xhtmll-transitional.dtd"> 
.<html xmlns="http://www.w3.0rg/1999/xhtml" 
xmlns:h="http://java.sun.com/jsf/html"> 
<h:head> 
<title>ch3 initializewithel index</title> 
</h:head> 
<h:body> 


<p> 圆 心 坐标 : (#{rc.x},#{rc.y})</p> 
<p> 圆 的 半径 : # {rc.c.radius}</p> 
<h:form> 


<h:outputLabel id="]1" for="il" value=" 输 入 新 的 半径 "/> 


<h:inputText id="il" value="#{circle.radius}"/> 
<h:commandButton value=" 提 交 "/> 
</h:form> 
</h:body> 
</html> 


当 页 面 被 第 一 次 请 求 时 ,请 求 作 用 域 的 rc 受 管 bean 实例 和 会 话 作用 域 的 circle 受 管 
bean 实例 会 被 依次 创建 和 初始 化 。 当 页 面 呈现 响应 后 ,rc 受 管 bean 实例 被 销毁 ,而 circle 
受 管 bean 实例 仍 保持 有 效 。 当 用 户 通过 表单 提交 再 次 请 求 该 页 面 时 ,circle 受 管 bean 实例 
的 radius 属性 被 重新 设置 ,在 页 面 呈 现 响 应 时 ,rc 受 管 bean 实例 被 再 次 创建 并 初始 化 。 


3:3.3 


在 Java 类 中 计算 EL 表达 式 


要 在 Java 类 (如 bean 类 ) 中 访问 EL 表达 式 ,需要 涉及 两 个 类 。 
(1) javax. faces. context. FacesContext。 


对 每 一 次 JSF 请 求 处 理 ,都 有 一 个 FacesContext 对 象 与 之 相关 联 。FacesContext 对 象 
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包含 着 本 次 请 求 处 理 的 所 有 状态 信息 。 

(2) javax. faces. application. Application 。 

每 一 个 JSF 应 用 都 存在 一 个 单一 的 、 能 被 所 有 用 户 共享 的 Application 对 象 , 它 提供 创 
建 和 计算 EL 表达 式 的 功能 。 

要 获得 与 当前 其 请 求 相 关联 的 FacesContext 对 象 ,可 以 调用 FacesContext 类 的 以 下 静 
态 方法 。 


public static FacesContext getCurrentInstance() 
要 获得 当前 JSF 应 用 的 Application 对 象 , 可 以 调用 FacesContext 对 象 的 以 下 方法 。 
public Application getApplication() 

要 计算 一 个 EL 表达 式 , 可 以 调用 Application 对 象 的 以 下 方法 。 


public <T>T evaluateExpressionGet (FacesContext context,String expression, 


Class<? extends T>expectedType) 


该 方法 有 3 个 参数 。 第 一 个 参数 需要 指定 一 个 FacesContext 对 象 。 第 二 个 参数 是 字 
符 串 ,其 内 容 是 需要 计算 的 EL 表达 式 。 第 三 个 参数 以 Class 对 象形 式 指 定 计算 结果 的 期 户 
类 型 ,该 参数 也 决定 了 方法 的 返回 类 型 。 方 法 返回 指定 EL 表达 式 的 计算 结果 。 
可 以 在 Java 类 中 定义 以 下 静态 方法 ,其 功能 是 返回 一 个 指定 名 称 的 bean 实例 。 方 法 
的 核心 代码 是 计算 一 个 EL 表达 式 ,表达 式 的 功能 是 访问 指定 名 称 的 bean 实例 。 如 果 该 
bean 实例 已 经 存在 , 则 直接 返回 ,否则 创建 并 返回 该 bean 实例 。 
public static Object getBean (String name){ 
FacesContext facesContext=FacesContext.getCurrentIinstance(); 
Application application=facesContext .getApplication(); 
Object bean=application.evaluateExpressionGet (facesContext,"#{"+namet+"}", 
Object.class); 
return bean; 


} 


假设 上 述 方法 定义 在 名 为 ELUtil 的 类 中 ,下 面 代 码 是 使 用 上 述 方法 的 一 个 示例 。 其 
中 ,user 是 一 个 受 管 bean 的 名 称 , 其 类 名 为 UserBean。 


UserBean bean= (UserBean)ELUtil.getBean ("user"); 


一 旦 获得 了 受 管 bean 实例 的 引用 ,就 可 以 像 调用 普通 Java 对 象 一 样 访问 该 bean 实 
例 。 上 述 方法 代码 既 可 以 出 现在 bean 类 中 ,也 可 以 用 于 在 普通 的 Java 类 中 。 但 需要 注意 
的 是 ,它们 必须 在 JSF 请 求 处 理 过 程 中 被 调用 和 执行 。 


3.6 小 结 


。 受 管 bean 是 指 受 JSF 框架 的 受 管 bean 工具 管理 的 JavaBean。 
。 开发 人 员 负 责编 写 受 管 bean 类 .配置 受 管 bean, 并 可 根据 需要 访问 受 管 bean 实例 。 
受 管 bean 工具 根据 访问 需要 和 配置 情况 ,负责 创建 .初始 化 受 管 bean 实例 ,并 维护 
»。5] 。 


受 管 bean 实例 。 

。 受 管 bean 的 配置 信息 包括 bean 名 称 、 作 用 域 和 属性 初 值 等 ,可 以 在 bean 类 中 用 相 
应 的 Java 标注 声明 ,也 可 以 在 Faces 配置 文件 中 用 相应 的 元 素 声 明 。 

。 EL 表达 式 分 为 值 表达 式 和 方法 表达 式 。 值 表达 式 用 于 访问 bean 的 属性 ,方法 表达 
式 用 于 调用 bean 的 方法 。 

。 页 面 呈现 时 ,相关 的 值 表 达 式 以 右 值 模式 计算 。 页 面 提交 时 ,相关 的 值 表达 式 以 左 
值 模式 计算 。 如 果 一 个 值 表达 式 , 既 需要 以 右 值 模式 计算 又 需要 以 左 值 模式 计算 ， 
则 其 访问 的 bean 属性 必须 是 可 读 写 的 。 

。 值 表达 式 中 可 包含 文字 和 运算 符 以 实现 简单 运算 ,此 时 值 表达 式 只 能 以 右 值 模式 
计算 。 

。 带 参数 的 方法 表达 式 可 以 作为 值 表达 式 使 用 ,此 时 它 只 能 以 右 值 模式 计算 。 


习 题 3 


1. 何谓 受 管 bean? 如 何 声明 受 管 bean? 

2. 受 管 bean 的 作用 域 有 哪 几 种 ? 简 述 视图 作用 域 与 请 求 作用 域 之 间 的 区 别 。 
3. 简 述 在 bean 类 中 计算 一 个 EL 表达 式 的 方法 。 

4. 假设 有 如 下 受 管 bean 类 : 


Package bean; 
import javax.faces.bean .ManagedBean; 


import javax.faces.bean.RequestScoped; 


@ManagedBean 

@RequestScoped 

public class Rectangle { 
private boolean isFill; 
private int width; 


private int height; 


public int getHeight (){ 
return height; 

} 

public void setHeight (int height){ 
this.height=height; 

} 

public int getwidth(){ 
return width; 

} 

public void setWwidth(int width){ 
this.width=width; 

} 

public int getArea(){ 
return widthx height; 
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} 

那么 该 受 管 bean 的 名 称 是 什么 ?类 名 是 什么 ?作用 域 是 什么 ? 可 读 写 属性 包括 哪些 ? 
只 读 属 性 包括 哪些 ? 

5. 假设 一 个 JSF 页 面包 含 如 下 表单 标记 : 


<h:form id="f"> 
<h:inputText id="i" value=""/> 
<h:commandButton value="OK" action="#{user.action}"/> 


</h:form> 
其 中 ,文本 域 的 value 属性 并 没有 与 某 受 管 bean 的 一 个 属性 进行 绑 定 ,那么 如 何在 名 为 
user 的 bean 的 action 方法 中 获取 用 户 在 文本 域 中 输入 的 值 ? 

6. 编制 一 个 JSF 应 用 (sh3_gcd) ,可 以 求 两 个 数 的 最 大 公约 数 。 应 用 包含 两 个 JSF 页 
面 。 第 一 个 页 面 允 许 用 户 输入 两 个 数 并 提交 ,如 图 3-4(a) 所 示 。 第 二 个 页 面 显示 计算 结果 ， 
单 击 命令 按钮 后 会 返回 第 一 个 页 面 ,如 图 3-4(b) 所 示 。 


) 求 最 大 公约 数 - Wozilla Fi... [Cc | 右 | 区 | } 求 最 大 公约 数 - Hozilla Fi... 化 | 右 | 区 | 
文件 @) 编辑 EE) 查看 W) 历史 G) 书签 四 文件 CD) 编辑 也) 查看 0) 历史 (5) 书签 四 


仿 - 本 -[B Mr /ocdhost:e080/: | @ -过 -[B Mt:miocahestaeoao/: 


实验 : 求 两 个 数 的 最 大 公约 数 数 20 和 数 12 的 最 大 公约 数 为 ，4 


数 1 20 ] 返回 
数 2 | 


图 3-4 第 6 题 示意 图 


7. 编制 一 个 JSF 应 用 (sh3_guess_number) ,实现 网 上 猜 数 游戏 。 每 次 游戏 开始 时 ,都 
会 自动 产生 一 个 1 一 100 的 随机 数 ,然后 显示 如 图 3-5(a) 所 示 的 页 面 。 若 用 户 输入 的 数 相 比 
预先 产生 的 随机 数 大 或 小 , 则 显示 类 似 如 图 3-5(b) 所 示 的 页 面 。 若 用 户 输入 的 数 与 预先 产 
生 的 随机 数 相等 , 则 显示 如 图 3-5Cc) 所 示 的 页 面 , 单 击 其 中 的 超 链 接 可 重新 开始 游戏 。 


) 猜 数 浅 戏 -Wozil1... 肥 |@| 民 | ) 靖 数 浅 戏 -ozil1. .. 肥 | 加 | 惨 ] [| 
文件 FE) 编辑 E) 查看 W) 历史 G)| 文件 F) 编辑 EE) 查看 (WW) 历史 (8)| 文件 ZJ) 编辑 E) 


gD Er [GD Er |4 -DD Er 
欢迎 来 玩 猜 数 游戏 太 小 了 ! 已 猜 2 次 ， 请 继续 。 成 功 ! 共 猜 了 6 次 。 


请 输入 [1, 100] 之 间 的 一 个 整数 ， 请 输入 [1, 100] 之 间 的 一 个 整数 ， 
75 提交 [es [本 


图 3-5 第 7 题 示意 图 


和 


第 4 章 使 用 JSF 标记 


本 章 主题 : 

。 JSF 页 面 概述 
JSF HTML 标记 概述 
基本 输入 类 标记 
。 基本 输出 类 标记 
。 图 像 标记 

。 动作 类 标记 

。 二 选 一 标记 
单 选 类 标记 
多 选 类 标记 

。 消息 标记 


在 JSF 应 用 中 ,用 户 界面 由 JSF 页 面 表示 ,JSF 页 面 主要 由 JSF 标记 组 成 。JSF 为 JSF 
页 面 的 创建 提供 了 两 种 可 选 的 技术 ,一 种 是 基于 JSP 的 技术 , 另 一 种 是 Facelets 技术 。 相 对 
来 说 ,Facelets 技术 为 开发 人 员 提 供 了 更 为 简单 易 用 且 功 能 强大 的 特性 ,并 成 为 JSF 2. 0 规 
范 中 首选 的 创建 JSF 页 面 的 技术 。 本 书 采用 基于 Facelets 技术 的 JSF 页 面 。 

在 JSF 标记 和 JSF 页 面 中 可 以 使 用 EL 表达 式 。 通 过 EL 表达 式 , 页 面 可 以 方便 地 访 
问 受 管 bean 属性 或 调用 受 管 bean 方法 。 这 是 JSF 页 面 与 普通 的 静态 Web 页 面 在 功能 上 
的 主要 区 别 。 基 于 这 一 机 人 制 , 既 可 以 有 效 地 将 应 用 的 数据 表示 与 数据 处 理 分 离 ,又 可 以 很 好 
地 将 它们 连接 在 一 起 。 

要 有 效 地 创建 JSF 页 面 , 必 须 熟 练 掌握 JSF 标记 的 使 用 。 本 章 首 先 对 JSF 页 面 和 JSF 
标记 进行 概述 ,然后 详细 介绍 大 多 数 基 本 的 JSF HTML 标记 的 功能 和 用 法 。 部 分 JSF 
HTML 标记 和 JSF 核心 标记 会 在 其 他 一 些 专门 的 章节 分 别 介绍 。 


4.1 JSF 页 面 概述 


JSF 页 面 由 一 些 不 同 种 类 的 元 素 (标记 组成。 这 里 先 对 组 成 JSF 页 面 的 各 种 标记 进行 
简单 描述 ,然后 对 JSF 核心 标记 做 总 体 介绍 。 


4.1.1 JSF 页 面 的 组 成 元 素 


基于 Facelets 技术 的 JSF 页 面 是 一 个 XHTML 页 面 , 其 文件 扩展 名 为 . xhtml。 
XHTML 是 一 种 符合 XML 语法 、 良 构 的 、 可 扩展 的 HTML。 

在 JSF 页 面 中 ,可 以 使 用 普通 的 HTML 标记 ,但 应 满足 以 下 要 求 : 

(1) 所 有 标记 必须 是 闭合 的 ,如 以 二 p 二 为 开始 标记 ,以 二 /p 二 为 结束 标记 。 如 果 是 单 
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独 不 成 对 的 标记 ,可 以 在 标记 最 后 加 斜 杠 “/” 来 关闭 它 , 如 二 br/ 二 。 

(2) 所 有 的 标记 名 和 属性 名 都 必须 是 小 写 的 。 

(3) 所 有 的 属性 值 应 该 用 单 引 号 或 双 引 号 括 起 来 。 

这 些 HTML 标记 不 需要 经 过 JSF 框架 的 特殊 处 理 , 通 常 被 原封 不 动 发 往 客户 端 。 

一 般 来 说 ,JSF 页 面 主要 由 JSF 标记 组 成 ,另外 也 可 包含 一 些 JSTL(JSP Standard Tag 
Library) 标 记 。 为 了 在 页 面 中 使 用 这 些 JSF 标记 或 JSTL 标记 ,需要 声明 相应 的 XML 名 称 
空间 。 表 4-1 列 出 了 JSF 支持 的 相关 标记 库 。 

表 41 JSF 支持 的 标记 库 


标 记 库 URI 例 EE 
JSF HTML 标记 库 http: //java. sun. com/js{/html h:body 
JSF 核心 标记 库 http: //java. sun. com/js{/core f:actionListener 
JSF Facelets 标记 库 http: //java. sun. com/js{/facelets ui:component 
JSF 复合 标记 库 http: //java. sun. com/js{/composite composite: interface 
JSTL 核心 标记 库 http: //java. sun. com/jsp/jstl/core c:forEach 
JSTL 函数 标记 库 http: //java. sun. com/jsp/jstl/functions fn:toUpperCase 


本 章 主要 介绍 JSF HTML 标记 库 的 标记 ,JSF 核心 标记 库 的 标记 将 分 散在 本 书 各 章 介 
绍 ,JSF Facelets 标记 库 和 复合 标记 库 将 在 第 10 章 介绍 。 有 关 JSTL 标记 库 的 内 容 , 读 者 可 
参阅 其 他 图 书 , 本 书 不 做 专门 介绍 。 

当然 ,JSF 页 面 大 多 会 包含 一 些 EL 表达 式 。EL 表达 式 既 可 以 出 现在 标记 的 属性 中 ， 
也 可 出 现在 页 面 的 静态 模板 文本 中 。 
4.1.2 JSF 核心 标记 一 览 

要 使 用 JSF 核心 标记 库 , 需 要 在 页 面 中 声明 相应 的 名 称 空间 : 

xmlns:f="http://java.sun.com/jsf/core" 

JSF 核心 标记 通常 执行 一 些 与 任何 特定 的 呈现 包 无 关 的 核心 动作 。 表 4-2 列 出 了 一 些 
常用 JSF 核心 标记 。 


表 4-2 常用 的 JSF 核心 标记 


类 别 标 记 功 能 
f:actionListener 为 父 组 件 添加 一 个 动作 监听 器 

事件 处 理 f:phaseListener 为 页 面 添加 一 个 阶段 监听 器 
f:valueChangeListener 为 父 组 件 添 加 一 个 值 变化 监听 器 
f:converter 为 父 组 件 添加 一 个 转换 器 

数据 转换 f:convertDateTime 为 父 组 件 添加 一 个 DateTime 转换 器 
f:convertNumber 为 父 组 件 添加 一 个 Number 转换 器 
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类 别 标 记 功 能 

f:validator 为 父 组 件 添 加 一 个 自 定 义 验证 器 
本 f:validateLength 为 父 组 件 添加 一 个 LengthValidator 验证 器 

人 fvialidateLongRange 为 父 组 件 添加 一 个 LongRangeValidator 验证 器 
f:validateDoubleRange 为 父 组 件 添加 一 个 DoubleRangeValidator 验证 器 
f:selectItem 指定 一 个 选项 

选项 设置 
f:selectItems 指定 一 组 选项 

参数 处 理 f: param 参数 化 消息 格式 模板 或 向 一 个 URL 添加 请 求 参数 

视图 参数 f:viewParam 为 页 面 视图 指定 一 个 视图 参数 

命名 关系 f:facet 为 嵌 套 于 它 的 组 件 与 包含 它 的 组 件 间 建 立 一 种 特定 关系 

本 地 化 f:loadBundle 装 入 一 个 资源 包 


4.2 JSF HTML 标记 概述 


本 节 对 JSF HTML 标记 做 总 体 描述 ,并 对 JSF HTML 标记 的 若干 基本 属性 进行 介绍 。 
4.2.1 JSF HTML 标记 一 览 

要 使 用 JSF HTML 标记 库 , 需 要 在 页 面 中 声明 相应 的 名 称 空 间 : 

xmlns:h="http://java.sun.com/jsf/html" 


JSF HTML 标记 又 称 JSF 组 件 标记 ,每 个 JSF HTML 标记 代表 某 种 UIComponent 组 
件 与 JSF 框架 的 HTML 呈现 包 中 某 个 呈现 器 的 一 种 组 合 。 一 个 JSF HTML 标记 在 服务 
器 端 表示 为 UIComponent 抽象 类 的 某 个 具体 子 类 的 实例 对 象 。 在 应 用 请 求 值 阶段 ,由 相应 
的 呈现 器 获取 属于 该 组 件 的 请 求 参数 并 保存 到 该 组 件 对 象 内 。 在 呈现 响应 阶段 ,由 相应 的 
呈现 器 将 组 件 对 象 呈现 为 对 应 的 HTML 标记 。 表 4-3 列 出 了 常用 的 JSF HTML 标记 。 
表 4-3 常用 的 JSF HTML 标记 


分 类 标 记 组 件 类 描 述 
表单 h:form HtmlForm 呈现 为 HTML form 元 素 
h:head UIOutput 呈现 为 HTML head 元 素 
头 与 体 
h:body UIOutput 呈现 为 HTML body 元 素 
h :inputText HtmlInputText 文本 域 
h :inputSecret HtmlInputSecret 口令 域 
基本 输入 
:inputTextarea HtmlInputTextarea 文本 区 
:inputHidden HtmlInputHidden 隐藏 域 


续 表 


分 类 标 记 组 件 类 描 述 
h:outputText HtmlOutputText 显示 单行 文本 
h:outputLabel HtmlOutputLabel 组 件 的 标签 

基本 输出 | h:outputLink HtmlOutputLink 超 链接 
h:outputFormat HtmlOutputFormat 带 参数 的 文本 
h:outputStylesheet UIOutput 链接 外 部 样式 表 

图 像 h:graphicImage HtmlGraphicImage 显示 图 像 

h:commandButton HtmlCommandButton 提交 按钮 或 重 置 按钮 

动作 h:commandLink HtmlCommandLink 作用 类 似 于 提交 按钮 的 超 链 接 
h:button HtmlOutcomeTargetButton 结果 按钮 

结果 
h:link HtmlOutcomeTargetLink 结果 超 链接 

二 选 一 h: selectBooleanCheckbox 复 选 框 
h:selectOneRadio HtmlSelectOneRadio 单 选 按钮 组 

单 选 h:selectOneMenu 单 选 菜单 
h:selectOneListbox 单 选 列表 框 
h:selectManyCheckbox 复 选 框 组 

多 选 h:selectManyMenu 多 选 菜单 
h:selectManyListbox 多 选 列 表 框 

消息 h: message 显示 组 件 消息 

消息 组 h: messages 显示 全 局 消息 

数据 表格 | hdataTable 显示 数据 表格 

列 hicolumn 指定 数据 表格 中 的 一 列 
h:panelGrid 网 格 面板 

面板 


:panelGroup 


HtmlPanelGroup 组 面板 


除 结果 类 标记 数据 表 格 标记 、 列 标记 、 面 板 类 标记 和 h:outputStylesheet 标记 外 , 表 中 
其 他 JSF HTML 标记 都 将 在 本 章 逐 一 介绍 。 结 果 类 标记 在 第 5 章 详细 介绍 ,数据 表格 标 
记 、 列 标记 ,面板 类 标记 和 h:outputStylesheet 标记 将 在 第 6 章 介绍 。 

绝 大 多 数 JSF HTML 标记 的 标记 名 都 由 两 部 分 组 成 ,前 半 部 分 是 相应 组 件 类 的 组 件 族 
名 ,后 半 部 分 是 相应 呈现 器 型 名 。 例 如 ,对 于 h:inputText 标记 ,其 组 件 族 名 为 Input, 其 呈 
现 器 型 名 为 Text。 

说 明 : 组 件 族 名 和 呈现 器 型 名 都 具有 前 缀 javax. faces。 所 以 上 述 组 件 族 的 完整 名 称 应 
该 是 javax. faces. Input, 呈 现 器 型 名 的 完整 名 称 应 该 是 javax. faces. Text。 

有 些 标记 名 并 不 符合 上 述 约定 : 


站- 人 二 


(1) 对 于 h:head 标记 ,相应 的 组 件 族 名 为 Output ,相应 的 呈现 器 型 名 为 Head。 

(2) 对 于 h:body 标记 ,相应 的 组 件 族 名 为 Output, 相 应 的 呈现 器 型 名 为 Body。 

(3) 对 于 h:form 标记 ,相应 的 组 件 族 名 和 呈现 器 型 名 均 为 Form。 

(4) 对 于 h:column 标记 ,相应 的 组 件 族 名 为 Column, 但 无 呈现 器 型 名 。h:column 标 
记 一 般 嵌 套 于 h:dataTable 标记 ,由 后 者 相应 的 呈现 器 统一 呈现 。 

每 个 JSF HTML 标记 组 件 都 有 组 件 族 名 和 呈现 器 型 名 两 个 属性 ,这 两 个 属性 共同 决定 
该 组 件 相关 的 呈现 器 类 型 。 下 面 代码 根据 组 件 族 名 和 呈现 器 型 名 返回 一 个 呈现 器 : 


RenderKit kit=FacesContext .getCurrentInstance () .getRenderKit (); 


Renderer renderer=kit.getRenderer ("javax.faces.Input", "javax.faces.Text"); 


进一步 ,同一 种 呈现 器 也 可 能 服务 于 不 同类 型 的 组 件 , 此 时 ,呈现 器 的 行为 也 会 因 组 件 类 型 
不 同 而 不 同 。 

h:head 标记 呈现 为 HTML head 标记 ,h:body 标记 呈现 为 HTML body 标记 ,h:form 
标记 呈现 为 HTML form 标记 。 

h:form 可 以 包含 一 组 子 组 件 标 记 , 并 在 呈现 时 形成 一 个 表单 。 一 个 表单 可 以 收集 用 户 
数据 ,这 些 数据 将 作为 请 求 参 数 随 HTTP 请 求 送 往 服 务 器 。 一 个 JSF 页 可 以 包含 多 个 表 
单 ,但 只 有 被 客户 提交 的 表单 的 数据 会 随 请 求 送 往 服务 器 。 

表 4-3 中 各 标记 是 按 其 相应 组 件 的 组 件 族 分 类 的 , 即 同一 组 各 标记 相应 组 件 具 有 相同 
的 组 件 族 名 。 例 如 ,基本 输入 类 中 各 标记 相应 组 件 的 组 件 族 名 为 Input, 单 选 类 中 各 标记 相 
应 组 件 的 组 件 族 名 为 SelectOne。 具 有 相同 组 件 族 名 的 组 件 类 往往 具有 共同 的 超 类 ,该 超 类 
名 为 UI 加 组 件 族 名 。 例 如 ,基本 输入 类 中 各 组 件 类 的 共同 超 类 为 UIInput, 单 选 类 中 各 组 
件 类 的 共同 超 类 为 UISelectOne。 当 然 ,所 有 的 组 件 类 都 是 UIComponent 抽象 类 的 子 类 。 

这 里 ,名 称 以 UI 开头 的 组 件 类 属于 javax. faces. component 包 , 名 称 以 Html 开头 的 组 
件 类 属于 javax. faces. component. html 包 。 


4.2.2 基本 属性 


下 面 是 一 些 基本 的 、 大 多 数 JSF HTML 标记 都 具有 的 属性 。 

1. id 

该 属性 用 于 指定 组 件 标识 符 。 组 件 标识 符 应 以 字母 打头 ,后 续 字符 可 以 是 字母 .数字 、 
下 划 线 "或 破 折 号 "一 "。 若 不 指定 该 属性 ,JSF 框架 会 在 需要 时 为 组 件 自动 产生 标识 符 。 

在 页 面 中 ,一 个 标记 可 以 通过 组 件 标识 符 引用 另 一 个 标记 。 例 如 ,可 以 按 下 面 方式 为 一 
个 输入 标记 设置 一 个 标签 ， 


<h:form id="forml"> 
<h:outputLabel for="inputl" value=" 请 输入 "/> 
<h:inputText id="inputl" value="123"/> 
<h:commandButton value="OK"/> 


</h:form> 
第 2.2. 3 小 节 曾 经 介绍 ,一 个 组 件 既 有 组 件 标识 符 , 又 有 客户 端 标 识 符 。 在 一 个 页 面 视 


图 内 ,各 组 件 的 组 件 标识 符 不 一 定 互 不 相同 ,但 其 客户 端 标识 符 总 是 唯一 的 。 所 以 在 服务 器 
二 的 


端 Java 代码 中 ,可 以 通过 组 件 的 客户 端 标识 符 唯 一 标识 一 个 组 件 对 象 : 
// 获 取 组 件 树 的 根 


UIViewRoot root=FacesContext.getCurrentInstance () .getViewRoot (); 

// 返 回 指定 客户 端 标识 符 的 组 件 对 象 

UIComponent component=root.findComponent ("forml:input1"); 

2. immediate 

输入 类 组 件 和 动作 类 组 件 通常 可 以 设置 mmediate 属性 。 该 属性 的 默认 值 为 false。 若 
将 其 设置 为 true, 则 输入 类 组 件数 据 值 的 转换 、 验 证 或 者 动作 类 组 件 动作 事件 的 处 理 将 会 在 
应 用 请 求 值 阶 段 直接 执行 ,而 不 会 等 到 验证 处 理 、 调 用 应 用 等 阶段 再 执行 。 

该 属性 设置 为 true 的 组 件 也 称 为 直接 组 件 。 第 8. 3.4 小 节 和 第 8. 5.4 小 节 所 举 的 两 
个 示例 都 用 到 了 该 属性 。 

3. rendered 

该 属性 决定 组 件 是 否 被 JSF 框架 呈现 输出 。 默 认 值 为 true, 即 组 件 会 被 呈现 .产生 相应 
的 HTML 标记。 经 常 地 ,可 以 将 该 属性 设置 为 一 个 boolean 型 EL 表达 式 , 从 而 能 根据 表 
达 式 的 计算 结果 ,动态 决定 一 个 组 件 是 否 被 呈现 输出 。 

4. style 和 styleClass 

这 两 个 属性 为 组 件 的 呈现 输出 指定 CSS(Cascading Style Sheets) 样 式 。style 属性 指定 
CSS 样式 ,并 作为 呈现 产生 的 HTML 标记 的 style 属性 值 ; styleClass 属性 指定 CSS 样式 
类 ,并 作为 呈现 产生 的 HTML 标记 的 class 属性 值 。 

下 面 代码 演示 了 这 两 个 属性 的 使 用 。outputl 组 件 使 用 style 属性 直接 指定 CSS 样式 ; 
output2 组 件 在 styleClass 属性 中 指定 了 一 个 样式 类 ,该 样式 类 定义 于 页 的 头 部 。 


<h:head> 
<title>style 与 styleClass 属性 </title> 
<style type="text/css"> 
.S11{ 
font-size: 24px 
} 
</style> 
</h:head> 
<h:body> 
<h:outputText id="outputl" style="color: red" value="style 属性 的 使 用 "/> 
<br/> 
<h:outputText id="output2" styleClass="sl" value="styleClass 属性 的 使 用 "/> 
</h:body> 


在 呈现 响应 阶段 ,outputl 组 件 和 output2 组 件 将 依次 产生 如 下 输出 : 


<span id="outputl" style="color: red">style 属性 的 使 用 < /span> 
<span id="output2" class="sl">styleClass 属性 的 使 用 < /span> 
5. value 和 binding 


value 属性 用 于 设置 组 件 值 。 该 属性 可 设置 为 普通 的 字符 串 文本 ,但 经 常设 置 为 EL 值 
8 和 


表达 式 ,使 组 件 值 与 受 管 bean 的 某 个 属性 绑 定 在 一 起 。 

binding 属性 总 是 设置 为 EL 值 表达 式 : 它 使 组 件 本 身 与 受 管 bean 的 某 个 属性 绑 定 在 
一 起 。EL 值 表达 式 的 类 型 必须 与 标记 代表 的 组 件 类 型 相 容 。 

下 面 代码 演示 了 binding 属性 的 使 用 。binding 属性 指定 cj 组 件 对 象 与 名 称 为 student 
的 受 管 bean 中 的 score 属性 绑 定 在 一 起 。 也 就 是 说 ,score 属性 引用 cj 组 件 对 象 。 


<h:inputText id="cj" binding="#{student.score}"/> 


这 样 ,就 可 以 在 bean 类 中 通过 score 属性 对 oj 组 件 进行 各 种 操作 。 当 然 ,首先 需要 bean 类 
中 对 score 属性 进行 声明 。 通 常 可 以 将 score 属性 的 类 型 声明 为 UIInput, 如 果 需 要 对 cj 组 
件 进行 与 呈现 相关 的 属性 的 操作 , 则 应 用 将 其 类 型 声明 为 HtmlInputText。 

6. title 

为 该 组 件 呈 现 产生 的 标记 元 素 指定 标题 信息 。Web 浏览 器 通常 会 将 该 信息 以 即时 提 
示 的 方式 显示 出 来 。 


4.3 基本 输入 类 标记 


基本 输入 类 标记 的 相应 组 件 类 有 共同 的 超 类 UIInput, 在 该 超 类 中 定义 了 这 些 组 件 共 
同 的 组 件 族 名 Input。 


4.3.1 标记 功能 


基本 输入 类 标记 共 四 个 。 

1.h:inputText 

文本 域 ,用 于 接收 一 行文 本 。 

在 服务 器 端 表 示 为 一 个 HtmlInputText 组 件 实例 。 组 件 呈现 为 HTML input 元 素 ， 
type 属性 设置 为 “text”。 

2. h.:inputSecret 

口令 域 , 与 文本 域 一 样 用 于 接收 一 行文 本 ,但 在 输入 时 仅 显 示 为 一 串 * ,而 不 会 显示 出 
用 户 实际 输入 的 内 容 。 

在 服务 器 端 表 示 为 一 个 HtmlInputSecret 组 件 实例 。 组 件 呈现 为 HTML input 元 素 ， 
type 属性 设置 为 “password”。 

3. h:inputTextarea 

文本 区 ,用 于 接收 多 行文 本 。 

在 服务 器 端 表示 为 一 个 HtmlInputTextarea 组 件 实例 。 组 件 呈 现 为 HTML textarea 
元 素 。 

4. h:inputHidden 

隐藏 域 , 人 允许 在 表单 中 隐藏 一 个 数据 ,以 便 在 表单 提交 时 ,该 数据 能 送 回 给 服务 器 。 

在 服务 器 端 表 示 为 一 个 HtmlInputHidden 组 件 实 例 。 组 件 呈现 为 HTML input 元 素 ， 
type 属性 设置 为 "hidden”。 


坟 省 了 


4.3.2 常用 属性 


下 面 介 绍 基本 输入 类 标记 常用 的 一 些 属 性 。 有 些 属性 可 能 仅 适 用 于 某 些 标记 ,而 不 适 
用 于 其 他 标记 。 有 些 标记 可 能 既 适 用 基本 输入 类 标记 ,也 适用 于 其 他 JSF HTML 标记 。 

(1) size: 用 于 指定 文本 域 或 口令 域 的 显示 宽度 ( 列 数 ) 。 

(2) maxlength: 用 于 指定 文本 域 或 口令 域 最 多 可 以 输入 的 字符 数 。 该 属性 最 终 会 成 
为 呈现 产生 的 HTML 标记 的 同名 属性 ,浏览 器 据 此 控制 用 户 输入 的 字符 数 。 在 服务 器 端 ， 
利用 代码 设置 组 件 值 时 并 不 受 此 属性 值 的 限制 。 

(3) cols、rows: 用 于 指定 文本 区 的 宽度 ( 列 数 ) 和 高 度 ( 行 数 )。 

(4) disabled: 指定 呈现 产生 的 HTML 元 素 是 否 禁 用 ,默认 值 为 false。 若 设置 为 true， 
呈现 产生 的 HTML 元 素 将 包含 属性 disableed 二 "disabled"。 此 时 ,HTML 元 素 为 禁用 状 
态 ,不 会 聚焦 。 

该 属性 适用 于 除 隐 藏 域 标记 外 的 其 他 基本 输入 类 标记 ,也 适用 于 选择 等 输入 标记 、 动 作 
标记 、h:link 标记 和 h:outputLink 标记 。 

(5) label: 指定 组 件 的 表现 名 。 当 显示 有 关 组 件 的 错误 消息 时 ,JSF 框架 会 用 该 名 称 代 
蔡 组 件 客户 端 标识 符 来 标识 组 件 ,使 错误 消息 的 可 读 性 更 强 。 

该 属性 不 适用 于 隐藏 域 标记 。 

(6) accesskey: 指定 呈现 产生 的 HTML 组 件 的 访问 键 , 当 用 户 按 下 二 ALT 二 十 过 访问 
键 二 时 将 激活 当前 组 件 。 

该 属性 适用 于 除 隐藏 域 标记 外 的 其 他 基本 输入 类 标记 ,也 适用 于 选择 等 输入 标记 ,动作 
标记 、h:outputLink 标记 以 及 h:outputLabel 标记 。 

当 h:outputLabel 标记 指定 了 访问 键 后 ,用 户 按 下 访问 键 时 ,将 激活 与 该 标签 相关 联 的 
组 件 , 如 聚焦 文本 域 . 选 中 复 选 框 。 

(7) readonly: 指定 呈现 产生 的 HTML 组 件 是 否 只 读 , 默 认 值 为 false。 若 设置 为 true， 
呈现 产生 的 HTML 元 素 将 包含 属性 readonly 一 "readonly" 。 

该 属性 适用 于 除 隐藏 域 标记 外 的 其 他 基本 输入 类 标记 ,也 适用 于 选择 等 输入 标记 。 

说 明 : 比较 readonly 和 disabled 属性 ,readonly 组 件 的 值 会 作为 请 求 参数 送 往 服务 器 ， 
而 disabled 组 件 的 值 不 会 送 往 服务 器 。 但 JSF 框架 并 不 对 readonly 组 件 请 求 值 做 任何 
处 理 。 

(8) redisplay: 指定 在 呈现 时 是 否 包 含 组 件 值 , 仅 适用 于 口令 域 标记 ,默认 值 为 false。 

(9) required: 指定 用 户 是 否 必须 为 该 输入 组 件 提供 值 ,boolean 型 。 属 性 值 为 true 的 
输入 组 件 也 称 为 必 填 项 。 

(10) requiredMessage: 指定 必 填 错误 消息 ,该 消息 将 代替 由 JSF 框架 产生 的 错误 消 
息 ,在 用 户 没 有 为 必 填 项 提供 值 时 显示 。 

(11) validator: 指定 一 个 方法 表达 式 ,引用 受 管 bean 的 一 个 方法 。 该 方法 称 为 验证 方 
法 ,通常 在 处 理 验证 阶段 被 调用 。 验 证 方法 的 方法 签名 如 下 : 


public void < 方法 名 > (FacesContext， UIComponent, Object) 


(12) validatorMessage: 指定 验证 错误 消息 ,该 消息 将 代替 由 任何 验证 器 产生 的 错误 消 


息 ,在 验证 出 错时 显示 。 
以 上 (9) 一 (12) 这 4 个 属性 不 仅 适用 于 基本 输入 类 标记 ,也 适用 于 选择 等 输入 标记 。 


4.4 基本 输出 类 标记 


基本 输出 类 标记 的 相应 组 件 类 有 共同 的 超 类 UIOutput ,在 该 超 类 中 定义 了 这 些 组 件 共 
同 的 组 件 族 名 Output。 


4.4.1 标记 功能 


基本 输出 类 标记 包括 4 个 。 

1. h:outputText 

显示 由 value 属性 指定 的 文本 ,需要 时 可 用 style 和 styleClass 属性 指定 显示 格式 。 

在 服务 器 端 表示 为 一 个 HtmlOutputText 组 件 实例 。 当 包含 id、style 和 styleClass 等 
属性 时 ,组 件 呈现 为 包含 文本 的 HTML span 元 素 ;否则 直接 呈现 文本 。 

2. h:outputLabel 

显示 一 串 文本 作为 某 输入 类 组 件 ( 或 动作 类 组 件 ) 的 标签 ,由 for 属性 指定 相关 联 的 输 
和 组件。 当 单 击 标签 时 ,会 聚焦 相关 的 输入 组 件 。 作 为 标签 的 文本 可 以 由 value 属性 指定 ， 
也 可 以 是 嵌 套 于 标记 内 的 文本 、 或 由 骨 套 于 标记 内 的 h:outputText 子 标记 指定 。 

该 标记 在 服务 器 端 表示 为 一 个 HtmlOutputLabel 组 件 实 例 。 组 件 呈现 为 HTML label 
元 素 。 

3. h:outputFormat 

显示 参数 化 文本 。 标 记 的 value 指定 一 个 称 为 消息 模板 的 特殊 字符 串 , 其 中 由 花 括 号 
括 起 来 的 数字 代表 一 个 参数 ,数字 表示 参数 编号 。 各 参数 值 则 可 由 和 嵌 套 于 该 标记 的 各 JSF 
核心 标记 f:param 的 value 属性 依次 指定 。 

下 面 代码 演示 了 该 标记 的 使 用 。 呈 现时 ,参数 (0} 蔡 换 为 LiMing ,参数 {1} 替 换 为 19 。 


<h:outputFormat value="{0} 今 年 {1} 岁 , {0} 是 学 计算 机 的 学 生 。"/> 
<f:param value="LiMing"/> 
<f:param value="19"/> 


</h:outputFormat> 


该 标记 在 服务 器 端 表 示 为 一 个 HtmlOutputFormat 组 件 实例 。 当 包含 id、style 和 
styleClass 等 属性 时 ,组件 呈现 为 包含 参数 化 文本 的 HTML span 元 素 ; 和 否则 直接 呈现 参数 
化 文本 。 

4. h:outputLink 

超 链接 。value 属性 指定 超 链接 的 目标 资源 的 URL。 超 链接 的 文本 (图 像 ) 由 嵌 套 于 该 
标记 的 静态 文本 或 其 他 标记 指定 ,如 h:outputText、h:graphicImage 等 。 

目标 资源 的 URL 可 以 是 绝对 URL 或 相对 URL。 对 于 相对 URL, 如 果 不 以 *“/” 开 头 ， 
则 相对 于 当前 页 面 所 在 的 路 径 ;如 果 以 “/” 开 头 , 则 相对 于 当前 Web 容器 根 目录 。 例 如 , 单 
击 下 面 标 记 产 生 的 超 链 接 , 可 以 导航 至 当前 Web 容器 中 上 下 文 路 径 为 “/jsfproject” 的 JSF 
应 用 的 response. xhtml 页 面 : 

让 省 


<h:outputLink value="/jsfproject/faces/response.xhtml"> 
超 链接 文本 
</h:outputLink> 
与 动作 类 标记 不 同 , 单 击 超 链接 不 是 产生 回 送 (postback) 请 求 , 而 是 产生 直接 请 求 。 可 
以 在 标记 中 嵌入 JSF 核心 标记 f:param 提供 请 求 参数 ,请 参看 第 4. 6. 3 小 节 中 的 应 用 示例 。 
该 标记 在 服务 器 端 表 示 为 一 个 HtmlOutputLink 组 件 实例 。 组 件 呈 现 为 HTML a 
元 素 。 


4.4.2 常用 属性 


基本 输出 类 标记 常用 的 属性 包括 id ,value style styleClass 等 基本 属性 ,其 中 value 属 
性 在 h:outputLink 标记 中 有 不 同 于 在 其 他 标记 中 的 作用 。 除 此 之 外 ,基本 输出 类 组 件 还 经 
常用 到 以 下 属性 : 

(1) escape: 指定 是 否 对 输出 内 容 中 的 特殊 字符 (如 所、 >、&&) 进 行 转 义 处 理 , boolean 
型 。 默 认 值 为 true, 此 时 特殊 字符 被 转 义 , 如 "到 ”转换 成 "&lt;”“ 二 ”转换 成 “Ragt”“&” 
转换 成 “&amp;”, 结 果 它 们 会 按 原样 在 显示 器 上 显示 出 来 。 若 设置 为 false, 组 件 值 不 被 转 
义 处 理 ,特殊 字符 将 会 被 浏览 器 解释 。 

该 属性 适用 于 h:outputText、h:outputLabel 和 h:outputFormat 标记 。 

(2) for: 指定 以 本 标记 为 标签 的 输入 类 组 件 或 动作 类 组 件 的 客户 端 标识 符 。 若 本 标签 
标记 与 关联 的 组 件 标记 处 于 同一 命名 容器 组 件 内 ,可 简单 指定 关联 组 件 的 标识 符 。 

该 属性 仅 适 用 于 h:outputLabel 标记 。 

(3) target: 指定 目标 资源 打开 的 位 置 。 默 认 情 况 下 ,目标 资源 会 在 当前 窗口 打开 。 如 
果 将 该 属性 设置 为 ”blank”, 目 标 资源 将 在 新 的 窗口 或 标签 页 内 打开 。 也 可 为 该 属性 设置 
一 个 名 称 ,那么 目标 资源 将 在 指定 名 称 的 窗口 或 标签 页 内 打开 。 

该 属性 适用 于 h:outputLink 标记 ,也 适用 于 h:form、h:commandLink 和 h:link 标记 。 


4.5 图 像 标记 


图 像 标 记 h:graphicImage 用 于 显示 一 幅 图 像 .属性 url( 或 value) 指 定 图 像 的 URL。 属 
性 width 和 height 指定 图 像 显示 的 宽度 和 高 度 。 

图 像 的 URL 可 以 是 绝对 URL 或 相对 URL。 对 于 相对 URL ,如果 不 以 “/” 开 头 , 则 相 
对 于 当前 页 面 所 在 的 路 径 ;如 果 以 “/” 开 头 , 则 相对 于 当前 JSF 应 用 的 上 下 文 路 径 。 例 如 ， 
下 面 标记 可 以 显示 当前 JSF 应 用 中 image 目录 下 的 tuxiang. jpg 图 像 : 


<h:graphicImage url="/image/tuxiang.jpg"/> 


该 标记 在 服务 器 端 表 示 为 一 个 HtmlGraphicImage 组 件 实例 。 组 件 呈 现 为 HTML img 元 
素 , 其 src 属性 等 于 组 件 的 url( 或 value) 属 性 。 如 果 应 用 使 用 URL 重 写 来 维护 会 话 ,组 件 
将 自动 重 写 URL 以 维护 会 话 。 


总 放生 


4.6 动作 类 标记 


动作 类 标记 的 相应 组 件 类 有 共同 的 超 类 UICommand, 在 该 超 类 中 定义 了 这 些 组 件 共 
同 的 组 件 族 名 Command 。 


4.6.1 标记 功能 
动作 类 标记 有 两 个 。 


1. h:commandButton 

动作 按钮 。type 属性 指定 按钮 的 类 型 , 若 类 型 为 submit( 默 认 ) ,产生 提交 按钮 , 单 击 按 
钮 会 产生 回 送 (postback) 请 求 . 引 发 相应 组 件 的 动作 事件 ; 若 类 型 为 reset, 单 击 按钮 不 会 产 
生 HTTP 请 求 , 只 是 将 表单 恢复 为 填写 前 的 状态 ,以 便 重新 填写 , 常 称 重 置 按钮 。 在 上 述 两 
种 情况 下 ,value 属性 值 作为 按钮 的 标题 。 动 作 按钮 主要 是 指 提交 按钮 。 

若 为 image 属性 设置 一 个 图 像 的 URL( 绝 对 或 相对 ), 则 产生 一 个 图 形 化 的 提交 按钮 。 
此 时 ,type 和 value 属性 被 忽略 。 

该 标记 必须 放置 在 h:form 标记 内 。 

该 标记 在 服务 器 端 表示 为 一 个 HtmlCommandButton 组 件 实例 。 组 件 呈 现 为 HTML 
input 元 素 , 其 type 属性 等 于 组 件 的 type 属性 ,value 属性 等 于 组 件 的 value 属性 。 如 果 组 件 包 
含 image 属性 , 则 input 元 素 的 type 属性 设置 为 “image” ,src 属性 设置 为 组 件 的 image 属性 。 

2. h:commandLink 

动作 超 链接 。 在 外 观 表 现 上 , 它 与 h:outputLink 标记 类 似 ,也 产生 一 个 超 链 接 元 素 。 和 髓 套 
的 h:outputText 标记 和 h:graphicImage 标记 都 可 以 指定 超 链接 的 文本 和 图 像 。 但 不 同 的 是 ， 
动作 超 链接 不 需要 指定 目标 资源 ,所 以 它 可 以 用 自身 的 value 属性 指定 超 链接 文本 。 

在 功能 行为 上 ,动作 超 链接 与 动作 按钮 相同 , 即 用 户 单 击 时 提交 表单 .引发 相应 组 件 的 
动作 事件 。 与 动作 按钮 标记 一 样 , 动 作 超 链接 标记 也 应 该 置 于 h:form 标记 内 。 

该 标记 在 服务 器 端 表示 为 一 个 HtmlCommandLink 组 件 实 例 。 组 件 呈 现 为 HTML a 
元 素 , 其 href 属性 值 为 *#”,onclick 属性 包含 一 段 JavaScript 代码 ,可 以 产生 提交 表单 .发 
送 回 送 请 求 的 功能 行为 。 


4.6.2 常用 属性 


动作 类 标记 的 功能 是 提交 表单 .引发 动作 事件 ,所 以 其 最 重要 的 属性 莫 过 于 涉及 动作 事 
件 处 理 的 两 个 属性 。 

(1) actionListener: 指定 一 个 方法 表达 式 .引用 受 管 bean 的 一 个 方法 。 该 方法 称 为 动 
作 监 听 方 法 ,会 在 组 件 引 发 动作 事件 时 被 自动 调用 ,通常 在 “调用 应 用 ”阶段 被 调用 。 动 作 监 
听 方 法 的 方法 签名 如 下 : 


public void < 方法 名 > (ActionEvent) 
或 


public void < 方法 名 > () 
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(2) action: 该 属性 在 前 面 已 被 多 次 使 用 。 它 既 可 以 指定 一 个 字符 串 文本 ,也 可 指定 一 
个 方法 表达 式 。 方 法 表达 式 引用 的 方法 称 为 动作 方法 ,会 在 组 件 引发 动作 事件 时 被 自动 调 
用 ,通常 在 “调用 应 用 ”阶段 被 调用 。 动 作 方 法 的 方法 签名 如 下 : 


public String < 方法 名 > () 
或 
public object < 方法 名 > () 


如 果 同 时 指定 了 动作 监听 方法 和 动作 方法 , 则 先 执行 动作 监听 方法 ,后 执行 动作 方法 。 
action 属性 指定 的 字符 串 或 其 指定 的 动作 方法 的 执行 结果 ,将 作为 导航 的 依据 。 这 里 ,如 果 
动作 方法 的 返回 类 型 是 Object, 那 么 JSF 框架 会 先 调 用 返回 结果 的 toString() 方 法 将 其 转 
换 成 字符 串 。 有 关 导 航 处 理 的 内 容 在 第 5 章 做 详细 介绍 。 

(3) target: 指定 响应 内 容 显示 的 位 置 。 默 认 情 况 下 ,响应 内 容 会 在 当前 窗口 显示 。 如 
果 将 该 属性 设置 为 ”blank”, 响 应 内 容 将 在 一 个 新 打开 的 窗口 或 标签 页 内 显示 。 也 可 为 该 
属性 指定 一 个 名 称 ,那么 响应 内 容 将 在 指定 名 称 的 窗口 或 标签 页 内 显示 。 

该 属性 适用 于 h:commandLink 标记 ,也 适用 于 h:form、h:outputLink 和 hl:link 标记 。 

h:commandButton 标记 没有 target 属性 .但 可 以 在 h:form 标记 中 设置 target 二 "_ 
blank" ,这 样 表单 内 所 有 的 动作 按钮 或 动作 超 链接 提交 表单 后 产生 的 响应 内 容 都 将 在 新 的 
窗口 或 标签 页 中 显示 。 


4.6.3 超 链接 与 动作 超 链接 标记 应 用 示例 


该 应 用 项 目 (ch4_link) 主 要 由 两 个 页 面 和 一 个 受 管 bean 组 成 。 项 目的 运行 效果 如 
图 4-1 所 示 。 


chd_link = | 
文件 @) 编辑 EE) 查看 WD) 历史 GE) 书签 @) 工具 CD) 帮助 


Mozilla Firefox 


人 -区 :| http:/1localhost:80801ch4_linky 


文件 人 F) 编辑 E) 查看 VW) 历史 G) 书签 @) 工具 CD) 帮助 虽 训 
后 > 办 "| http://1ocalhost 8080/ ch4_link/ faces/index. xhtnl; | al 
请 求 参数 ， 10 
bean 属 性 ， 11 


chd_link — Wozrilla Firefoz 
文件 @) 编辑 人 ) 查看 W) 历史 GE) 书签 @) 工具 加 ) 


-BD mt /ohost:000/ ch link/faces/response. xht [om 
请 求 参数 ， 11 
bean 属 性 ， 10 


完成 


图 4-1 应 用 ch4_link 运行 效果 图 
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1. 受 管 bean 

Index. java 是 应 用 唯一 的 一 个 受 管 bean( 代 码 清单 4-1), 其 名 称 为 me、 作 用 域 为 请 求 。 
bean 中 定义 有 一 个 age 属性 ,以 及 一 个 action 方法 。 

代码 清单 4-1 受 管 Bean(Index.java) 


. Package bean; 
. import javax.faces .bean.ManagedBean; 


. import javax.faces .bean.RequestScoped; 


E 

2 

3 

4. 

5. @ManagedBean (name= "me") 
6. @RequestSscoped 

7. public class Index { 

8 

9 private int age=10; 


10. public int getAge(){ 


Els return age; 

2 1 

13. public void setAge (int age){ 
Las this.age=age; 

15s } 

16s 

17. public String action(){ 
18， aget++; 

19. return "response"; 
20。 } 

2 3 

2. JSF 页 面 


应 用 包含 两 个 页 面 : 欢迎 页 面 index. xhtml 和 响应 页 面 response. xhtml。 

index. xhtml( 代 码 清单 4-2) 页 面 有 一 个 表单 ,表单 中 包含 一 个 文本 域 和 一 个 动作 超 链 
接 “*OK”。 文 本 域 中 初始 显示 受 管 bean 中 age 属性 的 值 ,但 用 户 可 以 输入 新 的 值 。 当 用 户 
单 击 动作 超 链 接 “OK” 时 ,将 产生 一 个 POST 请 求 ,用户 在 文本 域 输入 的 数据 作为 一 个 请 求 
参数 一 并 提交 。 服 务 器 接收 该 请 求 后 ,将 经 历 恢复 视图 .应 用 请 求 值 .处 理 验 证 等 各 阶段 。 
在 “更 新 模型 ”阶段 ,用 户 在 文本 域 中 输入 的 数据 被 保存 到 受 管 bean 的 age 属性 中 。 在 “ 调 
用 应 用 ”阶段 的 最 后 ,动作 超 链接 标记 的 action 属性 指定 的 受 管 bean 的 action 方法 被 执行 ， 
结果 age 属性 的 值 被 加 1, 然后 由 导航 处 理 器 导航 至 响应 页 面 。 

index. xhtml 页 面 还 包含 一 个 由 h:outputLink 标记 产生 的 普通 超 链接 。 该 标记 无 论 是 
出 现在 h:form 标记 内 还 是 出 现在 h:form 标记 外 ,其 效果 是 一 样 的 , 即 都 不 会 提交 表单 。 
其 子 标记 f:;param 指定 一 个 请 求 参 数 。 单 击 该 超 链 接 将 产生 一 个 GET 请求, 其 请 求 参数 作 
为 URL 的 一 部 分 会 出 现在 地 址 栏 中 。 在 这 里 ,请 求 的 目标 页 面 的 URL 以 及 请 求 参数 在 本 
页 面 呈 现时 就 已 经 完全 确定 。 

代码 清单 4-2 index. xhtml 


1. <?xml version='1.0' encoding='UTF-8' ?> 


。 66 。 


.<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
.<html xmlns="http://www.w3.0rg/1999/xhtml" 
xmlns:h="http://java.sun.com/jsf/html" 
xmlns:f="http://java.sun.com/jsf/core"> 


<h:head> 


ooamouw wb 


<title>ch4 link</title> 
9. </h:head> 
10. <h:body> 


11, <h:form id="f1"> 

FE <h:inputText id="il" value="# {me.age}"/> 

3. <h:commandLink id="cl" value="OK" action="#{me.action}"/> 
14. <p></p> 

L5s <h:outputLink value="/ch4 link/faces/response.xhtml"> 
16. 确定 

Ls <f:param name= "fl1:il" value="# {me.age+1}"/> 

18 . </h:outputLink> 

19. </h:form> 

20. </h:body> 

21. </html> 


response. xhtml( 代 码 清单 4-3) 是 一 个 响应 页 面 ,通过 两 个 EL 表达 式 依次 获得 和 显示 
请 求 参数 全 :i 的 值 和 受 管 bean 中 age 属性 的 值 。 
代码 清单 4-3 response. xhtml 


1.<?xml version='1.0' encoding= 1'UTE-8' ?> 

2. <!DOCTYPE html PUBLIC "- //W3C//DTD XHTML 1.0 Transitional//EN" 
3. "http://www.w3.0rg/TR/xhtmll/DTD/xhtmll-transitional.dtd"> 
4. <html xmlns="http://www.w3.0rg/1999/xhtml" 


5 xmlns:h="http://java.sun.com/jsf/html"> 
6 <h:head> 
7, <title>ch4 link</title> 
8 </h:head> 
9. <h:body> 
10. 请 求 参数 : 
FE <h:outputText value="#{param['f1l:i1']}"/> 
2 <p/> 
13, bean 属性 : 
14. <h:outputText value="#{me.age}"/> 


15. </h:body> 
16. </html> 


4.7 二 选 一 标记 


二 选 一 标记 h:selectBooleanCheckbox 用 于 显示 一 个 复 选 框 ,用 户 可 以 在 两 种 状态 中 选 
择 其 一 。 该 标记 的 value 属性 通常 绑 定 到 受 管 bean 的 一 个 布尔 型 属性 上 。 
人 


例如 ,一 个 表单 中 包含 以 下 两 个 标记 : 前 者 呈现 为 一 个 复 选 框 ,后 者 作为 该 复 选 框 的 
标签 。 


<h:selectBooleanCheckbox id="bc" value="#{index.accept}"/> 
<h:outputLabel for="bc" value=" 接 受 条 款 ?"/> 


其 中 h: selectBooleanCheckbox 标记 的 value 属性 绑 定 在 名 称 为 index 的 受 管 bean 的 
accept 属性 上 。accept 属性 的 类 型 应 该 是 boolean 或 Boolean。 表 单 提交 时 ,用 户 对 该 复 选 
框 上 的 选择 就 会 保存 在 accept 属性 中 。 

该 标记 在 服务 器 端 表示 为 一 个 HtmlSelectBooleanCheckbox 组 件 实例 。 组 件 呈现 为 
HTML input 元 素 ,其 中 type 属性 设置 为 “checkbox”。 


4.8 单 选 类 标记 


单 选 类 标记 的 相应 组 件 类 有 共同 的 超 类 UISelectOne, 在 该 超 类 中 定义 了 这 些 组 件 共 
同 的 组 件 族 名 SelectOne。 


4.8.1 标记 功能 


所 有 单 选 标记 都 由 子 标记 f:selectitem 或 f:selectItems 指定 选项 。 每 个 选项 有 一 个 标 
签 和 一 个 值 ,标签 显示 在 界面 上 。 对 所 有 单 选 标记 ,用 户 只 能 选择 一 项 ,当选 择 某 个 选项 时 ， 
该 选项 的 值 即 为 单 选 标记 组 件 的 值 。 单 选 类 标记 共 3 个 。 

1. hl:selectOneRadio 

单 选 按钮 组 , 单 击 按钮 图 标 或 标签 进行 选择 。 

该 标记 在 服务 器 端 表 示 为 一 个 HtmlSelectOneRadio 组 件 实例 。 呈 现时 ,由 子 标记 指定 
的 每 个 选项 被 呈现 为 一 个 HTML input 元 素 ,type 属性 设置 为 *radio”,name 属性 为 组 件 的 
客户 端 标识 符 ,value 属性 为 选项 值 。 每 个 input 元 素 都 有 各 自 的 id。 每 个 按钮 选项 的 标签 
嵌 套 于 HTML label 元 素 中 ,其 for 属性 指向 对 应 的 input 元 素 。 

2.h:selectOneListbox 

单 选 列表 框 。 有 一 个 size 属性 ,用 于 指定 显示 的 选项 数 , 单 击 滚动 条 或 下 拉 按 钮 可 显示 
其 他 选项 ; 若 不 指定 该 属性 ,所 有 选项 将 一 同 显示 。 

在 服务 器 端 表 示 为 一 个 HtmlSelectOneListbox 组 件 实例 。 组 件 呈 现 为 HTML select 
元 素 , 其 size 属性 设置 为 组 件 的 size 属性 。 由 子 标记 指定 的 每 个 选项 被 呈现 为 一 个 HTML 
option 子 元 素 。 

3. h:selectOneMenu 

单 选 菜 单 ( 下 拉 菜 单 )。 没 有 size 属性 ,一 次 仅 显 示 一 个 选项 , 单 击 下 拉 按 钮 可 显示 所 有 
选项 。 

在 服务 器 端 表示 为 一 个 HtmlSelectOneMenu 组 件 实例 。 组 件 呈 现 为 HTML select 元 
素 , 其 size 属性 设置 为 1。 由 子 标记 指定 的 每 个 选项 被 呈现 为 一 个 HTML option 子 元 素 。 


4.8.2 常用 属性 


除了 一 些 基 本 属性 (如 id、value 等 ) 单 选 类 标记 常用 的 属性 有 以 下 几 种 。 
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(1) border: 指定 边框 宽度 ,int 型 (以 像素 为 单位 ) 。 既 适用 于 单 选 按钮 组 标记 ,也 适用 
于 复 选 框 组 标记 (h:selectManyCheckbox) 。 

(2) enabledClass: 指定 可 用 选项 标签 的 CSS 样式 类 ,String 型 。 既 适用 于 单 选 类 标 
记 , 也 适用 于 多 选 类 标记 。 

(3) disabledClass: 指定 不 可 用 选项 标签 的 CSS 样式 类 ,String 型。 与 enabledClass 属 
性 一 样 ,适用 于 所 有 的 单 选 类 标记 和 多 选 类 标记 。 

有 关 可 用 选项 和 不 可 用 选项 的 含义 在 4. 8. 3 小 节 “ 选 项 设置 "中 介绍 。 

(4) hideNoSelectionOption: 指定 当 组 件 被 用 户 激活 时 ,“ 非 选择 项 ”是 否 被 隐藏 ， 
boolean 型 。 适 用 于 所 有 的 单 选 类 标记 和 多 选 类 标记 。 

有 关 “ 非 选择 项 ”的 含义 在 4. 8. 3 小 节 “ 选 项 设置 "中 介绍 。 

(5) layout: 指定 单 选 按 钮 组 中 的 单 选 按 钮 、 复 选 框 组 中 的 复 选 框 等 的 呈现 方向 ,String 
型 。 有效 值 包括 : 

。 lineDirection( 默 认 值 ,水 平方 向 )。 

。 pageDirection( 垂 直方 向 ) 。 

该 属性 既 适 用 于 单 选 按钮 组 标记 和 复 选 框 组 标记 (h:selectManyCheckbox) ,也 适用 于 
消息 组 标记 (h:messages) 和 组 面板 标记 (h:panelGroup) 。 


4. 8.3 选项 设置 


无 论 是 单 选 类 标记 还 是 多 选 类 标记 ,其 选项 都 由 f: selectItem 和 f: selectItems 子 标记 
提供 。 

1，f: selectItem 

该 标记 应 嵌 套 于 单 选 或 多 选 标记 内 ,为 选择 标记 指定 单个 选项 。 其 主要 属性 有 以 下 几 种 。 

。 itemLabel: 指定 选项 的 标签 (显示 的 文字 ) ,String 型 。 

。 itemValue: 指定 选项 值 ,Object 型 。 当 用 户 选 择 选项 时 ,该 值 作为 请 求 参数 送 往 服 
务 器 。 
itemDisabled: 指定 选项 是 否 禁用 ,Boolean 型 。 不 是 所 有 的 浏览 器 都 支持 。 

。 noSelectionOption: 指定 该 选项 是 否 为 “ 非 选 择 项 ”,Boolean 型 。 缺 省 值 是 false。 

。 value: 值 表达 式 , 指 向 一 个 SelectItem 实例 。 此 时 ,选项 的 各 项 数据 由 该 SelectItem 

实例 提供 。 

说 明 : 若 指定 了 value 属性 ,那么 itemLabel、itemValue 等 属性 被 忽略 。 

2.f: selectItems 

该 标记 应 艇 套 于 单 选 或 多 选 标记 内 ,为 选择 标记 指定 一 组 选项 。 在 选择 标记 内 ,可 以 同 
时 存在 f:selectItem 标记 和 f:selectItems 标记 。 

通常 情况 下 ,f:selectItems 标记 由 value 属性 指定 一 组 选项 。value 属性 必须 是 指向 下 
面 对 象 之 一 的 值 表 达 式 : 

。 单个 SelectItem 实例 。 

。 SelectItem 实例 集合 。 

。 SelectItem 实例 数组 。 

。 映射 (Map 对 象 ) 。 
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当 为 映射 时 ,映射 中 的 每 个 键 一 值 对 的 键 和 值 分 别 代表 一 个 选项 的 标签 和 值 。 其 他 情 
况 下 ,每 个 SelectItem 实例 确定 一 个 选项 的 各 项 数据 。 
SelectItem 类 位 于 javax. faces. model 包 ,下面 是 该 类 软件 接口 的 一 个 摘要 。 


public class SelectItem implements Serializable { 


SelectItem(); // 构 造 方法 
SelectItem(Object value,String label); // 构 造 方 法 

public String getLabel (); // 选 项 标签 

public void setLabel (String label); 

public Object getValue (); // 选 项 值 

public void setValue (Object value); 

public boolean isDisabled(); // 选 项 是 否 禁 用 
public void setDisabled(boolean disabled); 

public boolean isNoSelectionOption(); // 是 否 为 “ 非 选择 项 ” 


public void setNoSelectionOption (boolean noSelectionOption) 


4. 8.4 单 选 标记 应 用 示例 


该 应 用 项 目 (ch4_calorie) 主要 由 两 个 页 面 和 一 个 受 管 bean 组 成 ,可 以 计算 一 个 人 一 天 
需要 消耗 的 能 量 。 项 目的 运行 效果 如 图 4-2 和 图 4-3 所 示 。 


chd_calorie — ozrilla Firefox 


文件 FE) 编辑 FE) 查看 WW) 历史 G) 书签 @) 工具 中) 


二 - 中 “| http://localhost:8080/ch4_calorie/ 


每 天 热量 消耗 计算 表 


(kg) 
Cem) 


© 〇 在 大 多 数 时 间 ， 你 在 坐 著 ， 读 书 ， 项 键盘 ， 或 主要 从 事 计算 机 工作 

回 你 参加 轻 量 锻炼 ， 管 如 每 日 行走 小 于 2 个 小 时 . 

〇 你 白天 很 少 坐 下 并 从 事 繁重 家 务 劳动 ， 从 事 园艺 ， 或 每 日 跳舞 . 

〇 你 参加 体育 运动 ， 警 如 跑步 或 登山 ， 或 者 你 是 建筑 工人 或 自行 车 邮递 员 . 


计算 每 日 卡路里 消耗 


图 4-2 应 用 ch4_calorie 欢迎 页 面 


1. 受 管 bean 

Index. java 是 该 应 用 项 目 唯一 的 一 个 受 管 bean, 见 代码 清单 4-4。bean 中 定义 了 若干 
属性 : gender .age、height、weight 和 activity, 分 别 用 来 接收 用 户 在 欢迎 页 面 中 输入 的 性 别 、 
年 龄 ,身高 .体重 和 生活 习惯 的 值 。 这 些 属性 都 是 可 读 写 的 ,getter 方法 会 在 欢迎 页 面 显示 


7T0 。 


jFacelet Title 一 Wozilla Firefoz 
文件 E) 编辑 下 ) 查看 W) 历史 G) 书签 @) 工具 菩 帮助 


€ = BB “|B http://1oclhost:8080/ch4_calorie/ faces/index. xhtnl; jsessionid-35b74 


你 一 般 每 天 需要 2521 卡 能 量 

请 注意 ， 这 个 估计 是 根据 你 的 体重 、 身 高 年 龄 、 性 别 和 平均 活动 水 平 得 出 . 
你 能 使 用 这 信息 以 帮助 了 解 需要 多 少 卡路里 以 维护 你 的 体重 。 超 过 需求 会 使 体重 
增加 ， 少 于 需求 会 使 体重 减轻 ， 需 要 根据 实际 工作 和 锻炼 情况 决定 饮食 . 


计算 其 他 人 的 热量 需要 


图 4-3 应 用 ch4_calorie 响应 页 面 


时 调用 ,setter 方法 会 在 页 面 提交 时 被 调用 。 

bean 还 定义 了 一 个 List 二 SelectItem 放 型 的 只 读 属性 items, 该 属性 在 构造 方法 中 初始 
化 ,为 “生活 习惯 " 单 选 按钮 组 提供 各 选项 。 

bean 中 的 getResult 方法 实现 应 用 所 需 的 计算 功能 ,同时 提供 相应 的 只 读 属性 result。 
该 属性 在 响应 页 面 中 被 访问 。 

代码 清单 4-4” 受 管 bean(Index. java) 


1. package bean; 

2. import java.util.ArrayList; 

3. import java.util.List; 

4. import javax.faces .bean.ManagedBean; 
5. import javax.faces .bean.RequestScoped; 
6. import javax.faces .model .SelectItem; 

7 

8. @ManagedBean 


9. @RequestScoped 
10. public class Index { 


12. public Index(){ 


E35 items=new ArrayList<SelectItem> (); 

14. SelectItem item=new SelectItem(); 

5s item.setLabel ("在 大 多 数 时 间 , 你 在 坐 着 ,读书 ,项 键盘 ,或 主要 从 事 计算 机 工作 .") ; 
16, item.setValue (1.2); 

17。 items .add (item) 

18 . item=new SelectItem() 

19. item.setLabel ("你 参加 轻 量 锻炼 , 辟 如 每 日 行走 小 于 2 个 小 时 ."); 

20, item.setValue (1.55); 

21。 items .add (item) 7 

22。 item=new SelectItem(); 

2 item.setLabel ("你 白天 很 少 坐 下 并 从 事 繁重 家 务 劳动 , 从 事 园艺 ,或 每 日 跳舞 .") ; 
24. item.setValue (1.725); 

25. items.add (item); 

26。 item=new SelectItem(); 
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item. setLabel (" 你 参加 体育 运动 ,譬如 跑步 或 登山 ,或 者 你 是 建筑 工人 或 自行 车 邮递 员 .") ; 


item.setValue (1.9); 


items.add (item); 


private String gender="male"; 
public String getGender(){ 
return gender; 
} 
Public void setGender (String gender){ 


this.gender=gender; 


private int age; 
public int getAge(){ 
return age; 
和 
public void setAge (int age)1{ 


this.age=age; 


private int height; 

public int getHeight (){ 
return height; 

} 

public void setHeight (int height){ 
this.height=height; 


private int weight; 

public int getWeight (){ 
return weight; 

} 

public void setWeight (int weight){ 
this.weight=weight; 


private float activity=1.2f; 
public float getActivity()t{ 
return activity; 
} 
public void setActivity(float activity){ 


this.activity=activity; 


72. private List<SelectIitem>items; 


73. Ppublic List<SelectItem>getItems (){ 


74. return items; 

5 

76. 

77. Ppublic int getResult (){ 

78. float fltBMR; 

79。 //Calculate: Basal Metabolic Rate 

80 . if (gender.equals ("male")){ 

81, fltBMR= (float) (66 +weight *13.7 +height* 5 -age* 6.8); 
B25 } else { 

83 . fltBMR= (float) (655 +weightx 9.6 +height*1.8 -age* 4.7); 
84. } 

85. //Get Total Energy Needs 

86 . float fltTEN= (float)fltBMR* activity; 

87, return (int)fltTEN; 

88 . 再 

89,. } 

2. JSF 页 面 


应 用 包含 两 个 页 面 : 欢迎 页 面 index. xhtml 和 响应 页 面 response. xhtml。 

index. xhtml( 代 码 清单 4-5) 页 面 主要 提供 一 个 表单 ,让 用 户 输入 为 计算 日 能 量 消耗 量 
所 需 的 各 种 个 人 信息 。 

代码 清单 4-5 index. xhtml 


1. <?xm] version='1.0' encoding='UTF-8' ?> 
2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
3. "http://www.w3.0org/TR/xhtmll/DTD/xhtmll-transitional.dtd"> 
4. <html xmlns="http://www.w3.0rg/1999/xhtml" 
5 xmlns:h="http://java.sun.com/jsf/html" 
6. xmlns:f="http://java.sun.com/jsf/core"> 
苏 <h:head> 
8 <title>ch4 calorie</title> 
9. </h:head> 
10. <h:body> 


Ls <h:outputText value=" 每 天 热量 消耗 计算 表 " style="font- size: 25px"/> 
12, <h:form> 

3 <p> 

14. <h:outputText value= "请 输入 你 的 信息 :" style="font-weight: bolder"/> 
15, </p> 

16. 性 别 

A <h:selectOneRadio value="#{index.gender}" > 

Wy <f:selectItem itemLabel=" 男 " itemValue="male"/> 

Ls <f:selectItem itemLabel=" 女 " itemValue="female"/> 

20 . </h:selectOneRadio> 

2 年 龄 


Bs <h:inputText value="#{index.age}" size="3"/><br/> 


内 体重 


24. <h:inputText value="#{index.weight}" size="3"/>(kg)<br/> 

25， 身高 

26s <h:inputText value="#{index.height}" size= />(cm) 

272 <p/> 

28. 生活 习惯 

Pp <h:selectOneRadio value="#{index.activity}" layout="pageDirection"> 
30 . <f:selectItems value="#{index.items}"/> 

31。 </h:selectOneRadio> 

325 <p/> 

33. <h:commandButton value=" 计 算 每 日 卡路里 消耗 " action="response"/> 
34. </h:form> 

35. </h:body> 

36. </html> 


response. xhtml( 代 码 清单 4-6) 页面 通过 访问 bean 的 result 属性 ,完成 相应 的 计算 功 
能 并 显示 计算 结果 。 
代码 清单 4-6 response. xhtml 


,<?xml version='1.0' encoding= 'UTF-8' ?> 
.<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1l/DTD/xhtmll-transitional.dtd"> 
. <html xmlns="http://www.w3.0rg/1999/xhtml" 
xmlns:h="http://java.sun.com/jsf/html"> 
<h:head> 
<title>Facelet Title</title> 
</h:head> 
9. <h:body> 
10. 你 一 般 每 天 需要 


1 
要 
3 
4 
5 
6 
7 
8 


i <h:outputText value="#{index.result}" style="color: red"/> 
Ee 卡 能 量 
13。 <p></p> 


14. 请 注意 ,这 个 估计 是 根据 你 的 体重 、 身 高 .年龄 .性别 和 平均 活动 水 平 得 出 .<br/> 
25; 你 能 使 用 这 信息 以 帮助 了 解 需要 多 少 卡路里 以 维护 你 的 体重 。 超 过 需求 会 使 体重 增加 ， 
16. 少 于 需求 会 使 体重 减轻 . 需要 根据 实际 工作 和 锻炼 情况 决定 饮食 . 


EY <p></p> 

18. <p><h:outputLink value="index.xhtml"> 计 算 其 他 人 的 热量 需要 </h:outputLink></p> 
19. </h:body> 

20. </html> 


4.9 多 选 类 标记 


多 选 类 标记 的 相应 组 件 类 有 共同 的 超 类 UISelectMany ,在 该 超 类 中 定义 了 这 些 组 件 共 
同 的 组 件 族 名 SelectMany。 
er 


4.9.1 标记 功能 


与 单 选 标 记 一 样 ,所 有 多 选 标 记 也 都 由 子 标记 f:selectitem 或 f:selectItems 指定 选项 。 
与 单 选 组 件 不 同 ,多 选 组 件 可 以 同时 选择 多 个 选项 。 多 选 组 件 的 value 属性 值 应 该 为 数组 
或 集合 (Collection ) 。 

1. h:selectManyCheckbox 

复 选 框 组 , 单 击 复 选 框图 标 或 标签 进行 选择 。 

该 标记 在 服务 器 端 表示 为 一 个 HtmlSelectManyCheckbox 组 件 实例 。 呈 现时 ,由 子 标 
记 指 定 的 每 个 选项 被 呈现 为 一 个 HTML input 元 素 ,type 属性 设置 为 “checkbox”,name 属 
性 为 组 件 的 客户 端 标识 符 ,value 属性 为 选项 值 。 每 个 input 元 素 都 有 各 自 的 id。 每 个 复 选 
框 选项 的 标签 骨 套 于 HTML label 元 素 中 ,其 for 属性 指向 对 应 的 input 元 素 。 

2. h:selectManyListbox 

多 选 列表 框 ,size 属性 指定 显示 的 选项 数 。 单 击 可 选择 一 项 , 按 住 Ctrl 键 再 单 击 可 选择 
(或 取消 选择 ) 其 余 各 项 , 按 住 Shift 键 再 单 击 可 选择 连续 多 项 。 

在 服务 器 端 表示 为 一 个 HtmlSelectManyListbox 组 件 实例 。 组 件 呈 现 为 HTML select 
元 素 , 其 size 属性 设置 为 组 件 的 size, 元 素 包 含 multiple= "multiple" 属 性 设置 。 由 子 标 记 指 
定 的 每 个 选项 被 呈现 为 一 个 HTML option 子 元 素 。 

3. h:selectManyMenu 

多 选 菜 单 , 没 有 size 属性 ,每 次 仅 显 示 一 个 选项 ,可 选择 多 项 。 

在 服务 器 端 表示 为 一 个 HtmlSelectManyMenu 组 件 实例 。 组 件 呈 现 为 HTML select 
元 素 ,其 size 属性 设置 为 1 ,元素 包含 multiple 二 "multiple" 属 性 设置 。 由 子 标记 指定 的 每 个 
选项 被 呈现 为 一 个 HTML option 子 元 素 。 

实际 上 ,目前 浏览 器 并 不 支持 多 选 菜 单 ,h:selectManyMenu 标记 呈现 的 效果 仍然 是 多 
选 列表 ,只 不 过 一 次 仅 显示 一 个 选项 。 

在 Mazolla 浏览 器 中 ,多 选 菜单 的 显示 效果 甚至 没有 滚动 按钮 ,只 有 一 个 选项 标签 。 此 
时 可 以 按 住 Ctrl 键 加 箭头 键 移动 各 选项 。 当 一 个 选项 显示 出 来 时 ,可 以 释放 Ctrl 键 并 按 空 
格 键 选 择 或 取消 选择 该 选项 。 


4.9.2 常用 属性 


一 些 基本 属性 (如 id、value 等 ), 以 及 单 选 类 标记 具有 的 一 些 属性 也 常用 于 多 选 类 标记 。 
除 此 之 外 ,多 选 类 标记 还 包括 以 下 常用 属性 。 

(1) collectionType: 指定 保存 选择 结果 的 集合 的 具体 类 型 的 完整 类 名 。 

多 选 组 件 的 value 属性 值 应 该 为 数组 或 集合 (Collection) 。 默 认 情 况 下 ,value 属性 值 是 
字符 串 数 组 。 可 以 将 多 选 标记 的 value 属性 绑 定 在 受 管 bean 的 某 个 数组 类 型 的 属性 上 ,如 
果 数 组 元 素 类 型 不 是 字符 串 ,那么 JSF 框架 会 调用 标准 转换 器 或 自 定义 转换 器 对 数据 进行 
类 型 转换 。 

如 果 将 标记 的 value 属性 绑 定 在 受 管 bean 的 某 个 集合 类 型 属性 上 ,而 该 集合 类 型 是 接 
口 或 抽象 类 (如 List、Set 等 ) ,那么 可 以 用 该 collectionType 属性 指定 一 个 相应 的 具体 类 型 ， 
如 java. util. ArrayList。 当 提交 表单 时 ,JSF 框架 会 创建 该 属性 指定 的 具体 集合 类 型 的 实 
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例 ,并 将 选择 结果 保存 在 该 Collection 对 象 中 ,然后 赋 给 受 管 bean 的 属性 。 与 数组 不 同 , 保 
存 选择 结果 的 Collection 对 象 的 元 素 类 型 总 是 为 字符 串 。 
该 属性 适用 于 所 有 多 选 类 标记 。 


《2 
的 显示 。 


4.9.3 


selectedClass ,unselectedClass: 指定 CSS 样式 类 ,分 别 应 用 于 已 选 和 未 选 的 选项 
这 两 个 属性 仅 适用 于 h:selectManyCheckbox 标记 。 


多 选 标 记 应 用 示例 


该 应 用 项 目 (ch4_selectmany) 主 要 由 一 个 页 面 和 一 个 受 管 bean 组 成 。 页 面 上 方 是 一 
个 表单 ,包含 一 组 复 选 框 和 一 个 动作 按钮 。 当 用 户 完成 选择 、 单 击 动作 按钮 时 ,页 面 下 方 会 
显示 用 户 选 择 的 结果 ,如 图 4-4 所 示 。 


) ch4_sPlectaany 一 Wozilla Firefox 


文件 @) 编辑 E) 查看 WW) 历史 G) 书签 @) 工具 GO) 帮助 0 


@ -| Mt /ohost:0000/ch4_selectnsny/faces/index xhtnl; jsessionid= |w| DD| 


你 掌握 的 编程 语言 ， 
Java 语 言 口 语言 回 C++ 口 VisualBasic 


你 的 选择 ，Java、C++ 


完成 


图 4-4 应 用 ch4_selectmany 运行 效果 


1. 受 管 bean 

Index. java 是 该 应 用 唯一 的 受 管 bean( 代 码 清单 4-7)。bean 中 定义 了 一 个 可 读 写 的 
result 属性 ,其 类 型 为 字符 串 数 组 ,用 于 保存 用 户 选 择 结果 ;一 个 只 读 的 msg 属性 ,是 多 选 结 
果 的 一 个 字符 串 表 示 。 

代码 清单 4-7 受 管 bean(Index.java) 


二 六: 六 


. Package bean; 
. import javax.faces .bean.ManagedBean; 


. import javax.faces .bean.RequestScoped; 


. CManagedBean 
. QRequestScoped 


. public class Index { 


private String[] result; 

public String[] getResult (){ 
return result; 

public void setResult (String[] result){ 
this.result=result; 

} 

public String getMsg(){ 
if(result.length==0) return "没有 选择 。"; 


Le StringBuffer sb=new StringBuffer ("你 的 选择 : "+result[0]); 


18 . for (int i=1;i<result.length;i++){ 
19. sb.append ("、") .append (result [i]); 
20。 } 

21» return sb.tostring(); 

22。 } 

235 } 

2. JSF 页 面 


该 应 用 仅 包 含 一 个 index. xhtml 页 面 (代码 清单 4-8) ,其 中 复 选 框 组 标记 的 value 属性 
绑 定 在 受 管 bean 的 result 属性 上 ,输出 文本 标记 的 value 属性 绑 定 在 受 管 bean 的 msg 属 
性 上 。 其 中 ,输出 文本 组 件 仅 在 result 属性 不 为 null 时 才 呈 现 , 也 就 是 说 ,只 有 在 此 时 
getMsg 方法 才 会 被 调用 。 

代码 清单 4-8 index. xhtml 


1. <?xml version='1.0' encoding= 'UTF-8' ?> 

2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
3. "http://www.w3.0org/TR/xhtml1l/DTD/xhtmll-transitional.dtd" 
4. <html xmlns="http://www.w3.0rg/1999/xhtml" 

i xmlns:h="http://java.sun.com/jsf/html" 

6. xmlns:f="http://java.sun.com/jsf/core"> 

7. <h:head> 

多 


<title>ch4 selectmany</title> 
9. </h:head> 
10. <h:body> 


LL <h:form> 

2， <h:outputText value=" 你 掌握 的 编程 语言 : "/> 

bE <h:selectManyCheckbox id="cs" value="#{index.result}"> 

14. <f:selectItem itemLabel="Java 语 itemValu Java"/> 

5 <f:selectItem itemLabel="C 语言 temValue="C"/> 

16. <f:selectItem itemLabel="C++" itemValue="C++"/> 

17。 <f:selectItem itemLabel="VisualBasic" itemValue="VisualBasic"/> 
18. </h:selectManyCheckbox> 

Ls <p></p> 

20. <h:commandButton value=" OK "/> 

21, </h:form> 

22 <p></p> 

23 <h:outputText value="#{index.msg}" rendered="#{index.result!=null}"/> 


24. </h:body> 
25. </html> 


4.10 消息 标记 


JSF 在 处 理 请 求 时 可 能 会 产生 各 种 消息 ,包括 : 
。 标准 转换 器 或 自 定义 转换 器 在 转换 组 件 值 时 产生 的 错误 消息 ; 


。 设置 了 required 属性 的 组 件 未 获得 输入 值 时 产生 的 错误 消息 ; 
。 标准 验证 器 或 自 定义 验证 器 在 验证 组 件 值 时 产生 的 错误 消息 ; 
。 由 应 用 代码 根据 需要 自主 产生 的 各 种 消息 。 
通常 ,这 些 消 息 应 表示 成 FacesMessage 对 象 , 并 放置 在 消息 队列 中 ,最 后 由 h:message 
或 h:messages 消息 组 成 呈现 出 来 。 


4. 10.1 FacesMessage 类 


每 个 消息 包含 三 个 属性 : 概要 文本 (summary) ,详细 文本 (detail) 和 严重 级 别 (severity) ,用 
FacesMessage 实例 表示 。FacesMessage 类 的 构造 方法 有 : 

。 FacesMessage () // 概 要 和 详细 文本 均 为 nul1, 严重 级 别 为 信息 级 别 

。 FacesMessage (String summary) // 概 要 与 详细 文本 相同 ,严重 级 别 为 信息 级 别 

。 FacesMessage (String summary,String detail) // 严 重 级 别 为 信息 级 别 

。 FacesMessage (FacesMessage.Severity severity,String summary,String detail) 

FacesMessage 类 还 定义 了 4 个 表示 消息 严重 级 别 的 类 常量 : 

。 FacesMessage. SEVERITY_INFO: 信息 级 别 。 

。 FacesMessage. SEVERITY_WARN: 警告 级 别 。 

。 FacesMessage. SEVERITY_ERROR: 错误 级 别 。 

。 FacesMessage.SEVERITY_FATAL: 致命 级 别 。 

各 种 消息 产生 后 首先 被 放 入 消息 队列 中 ,最 后 在 “呈现 响应 ”阶段 被 显示 在 页 面 上 。 每 
个 消息 可 能 属于 某 个 特定 组 件 ( 组 件 消息 ), 也 可 以 属于 整个 页 面 ( 全 局 消息 )。 在 把 消息 放 
入 消息 队列 时 ,应 该 指明 消息 所 属 。 

应 用 代码 可 以 调用 FacesContext 对 象 的 addMessage 方法 将 消息 放 入 队列 ; 


FacesMessage msgl=new FacesMessage ("msg1"); 

FacesMessage msg2=new FacesMessage ("msg2"); 

// 将 消息 msg1 作为 组 件 (客户 端 标 识 符 为 £1:i1) 消息 放 入 消息 队列 。 
FacesContext.getCurrentInstance().addMessage ("fl1:il",msgl1); 
// 将 消息 msg2 作为 全 局 消息 放 入 消息 队列 。 


FacesContext .getCurrentInstance () .addMessage (null,msg2); 
4. 10.2 h:message 标记 


h:message 标记 称 为 消息 标记 ,用 于 显示 某 个 特定 组 件 引 发 的 消息 。 如 果 该 组 件 引 发 
了 多 个 消息 ,该 标记 显示 其 中 的 第 一 个 消息 。 

该 标记 在 服务 器 端 表示 为 一 个 HtmlMessage 组 件 实例 。 呈 现时 ,输出 消息 文本 。 如 果 
包含 id、style、styleClass 等 属性 ,消息 文本 租 套 于 HTML span 元 素 中 。 

如 果 要 显示 的 是 一 个 信息 级 别 的 消息 ,而 标记 指定 了 infoStyle、infoClass 属性 , 则 呈现 
时 将 用 这 些 属性 设置 HTML span 元 素 的 style、class 属性 。 对 其 他 级 别 的 消息 ,也 会 有 类 
似 的 处 理 。 

h:message 标记 包含 id style styleClass rendered binding 等 基本 属性 。 但 与 其 他 标 
记 不 同 ,该 标记 没有 value 属性 。 除 此 之 外 ,该 标记 还 包含 以 下 常用 属性 。 

we 


(1) for: 指定 消息 源 组 件 的 标识 符 , 即 当前 消息 组 件 将 显示 该 属性 指定 的 组 件 引 发 的 
消息 ,String 型 。 该 属性 既 适 用 于 h:message 标记 ,也 适用 于 h:outputLabel 标记 (含义 与 
作用 有 所 不 同 ) ,但 不 适用 于 h:messages 标记 。 

(2) showSummary: 指定 是 否 显 示 消 息 的 概要 文本 ,boolean 型 ,默认 值 为 false。 

(3) showDetail: 指定 是 否 显示 消息 的 详细 文本 ,boolean 型 ,默认 值 为 true。 

(4) infoStyle: 指定 信息 级 别 消息 的 CSS 样式 ,String 型 。 

(5) infoClass: 指定 信息 级 别 消息 的 CSS 样式 类 ,String 型 。 

(6) warnStyle: 指定 警告 级 别 消息 的 CSS 样式 ,String 型 。 

(7) warnClass: 指定 警告 级 别 消 息 的 CSS 样式 类 ,String 型 。 

(8) errorStyle: 指定 错误 级 别 消息 的 CSS 样式 ,String 型 。 

(9) errorClass: 指定 错误 级 别 消息 的 CSS 样式 类 ,String 型 。 

(10) fatalStyle: 指定 致命 级 别 消息 的 CSS 样式 .String 型 。 

(11) fatalClass: 指定 致命 级 别 消息 的 CSS 样式 类 ,String 型 。 

(12) tooltip: 指定 在 showDetail 属性 和 showSummary 属性 均 为 true 的 情况 下 ,是 否 
以 工具 提示 方式 显示 消息 的 概要 文本 ,boolean 型 ,默认 值 为 false。 


4. 10.3 h:messages 标记 


h:messages 标记 称 为 消息 组 标记 ,可 以 显示 所 有 全 局 消息 和 组 件 消息 。 如 果 一 个 组 件 
引发 了 多 个 消息 ,这 些 消 息 都 会 被 显示 。 

该 标记 在 服务 器 端 表示 为 一 个 HtmlMessages 组 件 实例 。 组 件 呈 现 为 HTML table 元 素 
或 HTML ul 元素 ,每 个 消息 呈现 为 一 个 HTML tr 元 素 ( 表 格 行 ) 或 HTML Li 元素 ( 列 表 项 ) 。 
组 件 的 id、style、styleClass 等 属性 将 设置 table 元 素 或 ul 元素 的 相应 属性 (id、style 和 class 属 
性 ) ,组 件 的 infoStyle ,infoClass 等 属性 将 设置 tr 或 i 元 素 的 相应 属性 (style 和 class 属性 ) 。 

h:messages 标记 的 常用 属性 与 h: message 标记 类 似 , 但 存在 着 一 些 差异 。 

(1) h:messages 标记 没有 for 属性 。 

(2) h:messages 标记 特有 的 globalOnly 属性 ,用 于 指定 是 否 仅 显示 全 局 消息 ,默认 值 
为 false。 即 在 默认 情况 下 , 既 显 示 全 局 消息 ,也 显示 组 件 消息 。 

(3) 与 h:message 标记 不 同 ,在 消息 组 h:messages 标记 中 ,showSummary 属性 的 默认 
值 是 true,showDetail 属性 的 默认 值 是 false。 

(4) h:messages 标记 包含 layout 属性 ,用 于 指定 是 以 列表 (list) 形 式 还 是 表格 (table) 
形式 显示 各 消息 ,String 型 ,默认 值 为 “list”。 

h:panelGroup 标记 也 包含 layout 属性 ,但 含义 有 所 不 同 。 

(5) h:messages 标记 同样 包含 infoStyle、infoClass、tooltip 等 属性 ,但 这 些 属性 针对 要 
显示 的 每 一 条 消息 。 


4.11 论坛 一 登录 与 注册 
本 书 将 以 一 个 简易 论坛 ( 取 名 为 轻松 论坛 ) 的 开发 作为 JSF 的 一 个 主要 应 用 例子 。 这 


个 应 用 系统 的 开发 会 随 着 相关 知识 点 的 引入 ,介绍 而 逐步 展开 。 为 保持 相对 的 独立 性 ,每 引 
。79 。 


入 一 些 功能 ,都 会 创建 一 个 JSF 应 用 项 目 。 

本 节 介 绍 论坛 应 用 中 的 登录 和 注册 功能 ,相应 的 应 用 项 目 名 为 luntan_logandreg。 与 
2.4 节 介绍 的 登录 应 用 相 比 ,该 应 用 在 功能 上 增加 和 增强 了 很 多 ,主要 包括 : 

(1) 增加 了 注册 功能 。 除 了 用 户 名 和 密码 ,客户 信息 还 包括 性 别 、 文 化 程度 和 电子 邮 
箱 等 。 

(2) 本 应 用 包括 三 个 页 面 : 主页 登录 页 面 和 注册 页 面 。 主 页 能 显示 当前 注册 人 数 \ 在 
线 人 数 。 若 用 户 还 没有 登录 ,能 从 主页 导航 至 登录 页 面 和 注册 页 面 。 已 登录 的 用 户 也 可 以 
退出 ( 登 离 ) 。 

(3) 登录 页 面 和 注册 页 面 中 包含 消息 组 件 。 当 登录 失败 或 注册 信息 不 合 要求 时 ,会 在 
所 在 页 面 显示 错误 消息 。 当 登录 或 注册 成 功 时 ,将 返回 到 主页 。 

该 应 用 的 运行 效果 如 图 4-5 所 示 。 其 中 : (a) 和 (b) 分 别 是 主页 在 用 户 未 登录 和 用 户 已 
登录 两 种 状态 下 的 呈现 结果 ;(c) 是 登录 页 面 的 呈现 结果 ;(d) 是 注册 页 面 的 呈现 结果 。 


轻松 论坛 -主页 - Worilla Fir... 区 | 器 | 区 | ) 轻松 论坛 -主页 - Norilla Fir... 夸 | 右 | 区 | 
文件 中) 编辑 FE) 查看 WD 历史 GB) 书 答 四 ] 


后 " 鞍 ， 回 http://localhost:8080/lantr | 于 | 辽 « - BB | http://locdhost:B080/lunter 四 站 | 
注册 人 数 :3， 在 线 人 数 :0 注册 人 数 :3， 在 线 人 数 :1 
登录 注册 linming: 退出 


[jE3 Worilla Fir... EC || 区 | 
文件 E) 编辑 E) 查看 W) 历史 G) 书签 B) 了 


@ -Mt /Nochost 000/1ontu [el 


请 登录 : 


用 户 名 (mn) [lining inine 
窗 码 (p) rerer 密码 we 

确认 密码 me | 
新 用 户 注 册 。 (和 对 性 别 | 更 国 一 


文化 程度 | 请 迁 标 ..。 ” 国 
电子 邮箱 |1ining@163. con 


[要  [ 琶 ] 


寺 成 


图 4-5 应 用 luntan_logandreg 运行 效果 图 


4.11.1 创建 模型 


首先 在 源 包 下 创建 一 个 名 为 entity 的 Java 包 , 并 在 该 包 中 创建 一 个 表示 用 户 的 Client 
类 。 该 类 定义 了 username、password 等 6 个 实例 变量 ,除了 若干 构造 方法 ,每 个 实例 变量 都 
有 相应 的 getter 和 setter 方法 。 代 码 清单 4-9 给 出 了 Client 类 的 定义 ,其 中 各 实例 变量 相 
应 的 getter 和 setter 方法 被 省 略 了 。 

代码 清单 4-9 Client. java 


1. package entity; 
。80 。 


. Public class Client { 


Private String username; 


private char gender; 


区 

3 

4 

5. Pprivate String password; 
6 

时 private String email; 

8 


private Character degree; 


9. private char status; // 是 否 在 线 
10. 
11. Ppublic Client(){ 
2 # 
13. public Client (String username){ 
14. this.username=username; 
15, 站 
16. public Client (String username, String password, char gender, String email,char status){ 
17。 this.username=username; 
EE this.password=password; 
EA this.gender=gender; 
20. this.email=email; 
21. this.status=status; 
22。 } 
23s 
24. // 各 实例 变量 相应 的 getter 和 setter 方法 
25。 
26.} 


然后 在 源 包 下 创建 一 个 名 model 的 Java 包 , 并 在 该 包 中 创建 DataBase 和 ClientManager 
两 个 Java 类 。DataBase 类 (代码 清单 4-10) 模 拟 应 用 的 业务 数据 , 即 用 户 数据 。 这 里 ,用 一 
个 Map<String，Client 二 型 对 象 存储 注册 用 户 的 数据 。ClientManager 类 (代码 清单 4-11) 
定义 了 应 用 所 需 的 各 种 业务 处 理 。 

代码 清单 4-10 DataBase. java 


package model; 
import entity.Client; 


import java.util.HashMap; 


public class DataBase { 


Ss 

EE 

4. import java.util.Map; 
Ss 

6 

a Private static final Map<String,Client>clients=new HashMap< String,Client> (); 
8 


static { 
9. Client cl=new Client ("loubuye","123456", 4 二 ?9 "loubuye@163.com",'0'); 
10. cl.setDegree('1'); 
11。 clients.put ("loubuye",c1); 
2 Client c2=new Client ("zhaoyy","123456", "中 "zhaoyy@163.com",'0'); 
3 clients.put ("zhaoyy",c2); 


。8]1 。 


14. 
15, 
16. 
了。 
218， 


} 
public static Map<String,Client>getClients (){ 


return clients; 


} 


代码 清单 4-11 ClientManager. java 


. Package model; 
. import entity.Client; 
. import java.util.Collection; 


. import java.util.Map; 


. Public class ClientManager { 


public Client findClientByName (String name){ // 查 找 用 户 
Client client=DataBase .getClients () .get (name); 
return client; 
} 
public boolean insertClient (Client client){ // 添 加 新 用 户 
String username=client .getUsername(); 
boolean success=false; 
Map<String,Client>clients=DataBase.getClients(); 
if(clients.get(username)==nul1l)1{ 
clients.put (username,client); 
success=true; 
} 
return success; 


} 


public int getNumOfClient (){ // 返 回 所 有 用 户 数 
return DataBase.getClients() .size(); 

} 

public int getNumOfOnline(){ // 返 回 状态 为 '1' 的 用 户 数 


Map<String,Client>map=DataBase.getClients(); 
Collection<Client>coll=map.values (); 

int n=0; 

for(Client c:coll){ 


if(c.getStatus () "1') n++ 7 
} 
return n; 
} 
public void logoff (Client client){ // 将 用 户 状态 设置 为 '0' 


client.setstatus('0'); 
} 
public void login(Client client){ // 将 用 户 状态 设置 为 '1' 


client.setSstatus('1'); 


4.11.2 创建 受 管 bean 


首先 在 源 包 下 创建 一 个 名 为 util 的 Java 包 , 并 在 该 包 中 创建 ELUtil 类 。 该 类 提供 两 
个 静态 方法 ,可 以 分 别 计算 一 个 EL 表达 式 和 获取 一 个 受 管 bean。 这 两 个 实用 方法 主要 是 
为 受 管 bean 类 的 定义 提供 方便 ,比如 一 个 受 管 bean 要 访问 另 一 个 受 管 bean, 可 以 先 调用 
ELUtil 类 的 getBean 方法 获得 那个 bean。 代 码 清单 4-12 给 出 了 ELUtil 类 的 代码 。 

代码 清单 4-12 ELUtil. java 


1. package util; 
2. import javax.faces .application.Application; 
3. import javax.faces.context .FacesContext; 
4. 
5. public class ELUtil { 
6. // 方 法 接收 一 个 EL 表达 式 字符 串 ,计算 并 返回 表达 式 的 值 
7. public static Object evalEL (String el){ 
8 FacesContext facesContext=FacesContext .getCurrentInstance () 
9. Application application=facesContext.getApplication(); 
10. Object value=application.evaluateExpressionGet (facesContext,el,Object .class); 
11。 return value; 
12s 3 


13. // 方 法 返回 指定 名 称 的 受 管 bean 
14. public static Object getBean (String name){ 


15。 return evalEL("#{"+namet+"}"); 


17。} 


然后 在 源 包 下 创建 一 个 名 为 bean 的 Java 包 ,并 在 该 包 中 定义 Index、Login、Registry 
和 SessionInfo 这 4 个 受 管 bean 类 。 其 中 ,Index、Login 和 Registry 是 请 求 作 用 域 的 受 管 
bean ,SessionInfo 是 会 话 作 用 域 的 受 管 bean。 

Index. java( 代 码 清单 4-13) 作为 主页 (index. xhtml) 的 支撑 bean, 提 供 两 个 可 读 属性 : 
numgOfClient 和 numOfOnline, 以 及 一 个 实现 "退出 ”的 动作 方法 。 

代码 清单 4-13” 受 管 bean(Index. java) 


1. package bean; 
2. import entity.Client; 
3. import javax.faces .bean.ManagedBean; 
4. import javax.faces .bean.RequestScoped; 
5. import model .ClientManager; 
6. import util.ELUtil; 
7 
8. @ManagedBean 
9. @RequestScoped 
10. public class Index { 
11. Ppublic int getNumOfClient (){ // 获 得 注册 人 数 
2 ClientManager cm=new ClientManager (); 


。，83 。 


13, 
14. 
15。 
16» 
WT 
18. 
319。 
20。 
21, 
22. 
23。 
24. 
25。 
26 . 
27. 


return cm.getNumOfClient (); 


} 


public int getNumOfOnline (){ // 获 得 在 线 人 数 


ClientManager cm=new ClientManager (); 


return cm.getNumOfOnline(); 


} 


public String exit (){ // 用 户 * 退 出 ”动作 方法 


SessionInfo sessinfo= (SessionInfo)ELUtil.getBean ("sessinfo"); 


Client client=sessinfo.getClient (); 


sessinfo.setClient (null); 


ClientManager cm=new ClientManager (); 


cm.logoff (client); 


return null; 


} 


Login. java( 代 码 清单 4-14) 作 为 登录 页 面 (login. xhtml) 的 支撑 bean ,提供 用 户 名 和 密 
码 两 个 相对 应 的 可 读 写 属性 ,以 及 实现 “登录 ”的 动作 方法 。 
代码 清单 4-14 受 管 bean(Login. java) 


. import 
. import 
. import 
. import 
. import 
. import 
. import util .ELUtil; 


. Package bean; 


entity.Client; 


javax. 
javax. 
javax. 


javax. 


model 


. CManagedBean 


faces .application.FacesMessage; 
faces .bean.ManagedBean; 
faces .bean.RequestScoped; 


faces.context.FacesContext; 


.ClientManager; 


。Q@RequestScoped 


. Public class Login { 


private String name; 


public String getName (){ 


return name; 


} 


public void setName (String name){ 


this.name=name; 


} 


private String pw; 


public String getPw(){ 


return pw; 


} 


public void setPw (String pw){ 


this .pw=pw; 


27. public String login(){ //* 登 录 ” 动 作 方 法 


28: ClientManager cm=new ClientManager (); 

295 Client client=cm.findClientByName (name) 

30, if(client==nul1)1{ 

31s FacesMessage msg=new FacesMessage ("用 户 名 不 存在 "); 

32> FacesContext .getCurrentInstance () .addMessage ("fi:username",msg); 
33。 return null; 

34. } else if(client.getSstatus()=="'1'){ 

35s FacesMessage msg=new FacesMessage ("该 用 户 已 在 线 "); 

36. FacesContext .getCurrentInstance () .addMessage ("fi:username",msg); 
37。 return null; 

38 . } else if(!client.getPassword() .equals (pw)){ 

39. FacesMessage msg=new FacesMessage ("密码 错误 "); 

40. FacesContext .getCurrentInstance () .addMessage ("fi:password",msg); 
41. return null; 

42. } 

43. SessionInfo sessinfo= (SessionInfo)ELUtil.getBean ("sessinfo"); 

44. cm.login (client); 

45. sessinfo.setClient (client); 

46. return "index"; 

47. } 

48. } 


Registry. java( 代 码 清单 4-15) 作 为 注册 页 面 (registry. xhtml) 的 支撑 bean, 提 供 一 个 
Client 型 的 可 读 写 属性 client .一 个 String 型 的 可 读 写 属性 password1, 以 及 实现 “注册 ”的 


动作 方法 。 这 里 client 属性 必须 事先 实例 化 ,passwordl 属性 与 确认 密码 相对 应 。 
代码 清单 4-15 ” 受 管 bean(Registry. java) 


. Package bean; 

. import entity.Client; 

. import javax.faces .application.FacesMessage; 
。 import javax.faces .bean.ManagedBean; 

. import javax.faces .bean.RequestScoped; 

. import javax.faces.context.FacesContext; 


. import model.ClientManager; 


oA 人 Dp 


. import util.ELUtil; 


10. @ManagedBean 

11. @RequestScoped 

12. public class Registry { 

13. private Client client=new Client (); 
14. public Client getClient (){ 

15. return client; 

6。 $ 

17. public void setClient (Client client){ 


18 . this.client=client; 
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149。 于 
20. Private String passwordl1; 


21. public String getPasswordl () { 


人 2 return passwordl1; 

23。 } 

24. public void setPasswordl(String password1){ 

5 this.passwordl=passwordl1; 

26. 1 

27. public String registry(){ // 注 册 “ 提 交 ” 动 作 方 法 

28. if(!passwordl.equals (client .getPassword()))t{ 

29. FacesMessage msg=new FacesMessage ("两 次 输入 的 密码 不 一 致 "); 

30 . FacesContext .getCurrentInstance () .addMessage ("fi:passwordl1",msg); 
31s return null; 

32。 } 

33s ClientManager cm=new ClientManager (); 

二 4 Client clientl=cm.findClientByName (Client.getUsername ()); 

355 if(client1l!=null){ 

36. FacesMessage msg=new FacesMessage ("用 户 名 已 被 使 用 "); 

二 FacesContext .getCurrentInstance () .addMessage ("fi:username",msg); 
38. return null; 

395 } 

40. client.setstatus('1'); 

41. boolean f=cm.insertClient (client); 

42. E01£){ 

43. FacesMessage msg=new FacesMessage ("注册 出 错 "); 

44. FacesContext .getCurrentInstance () .addMessage ("fi:username",msg); 
45. return null; 

46. } 

Le SessionInfo sessinfo= (SessionInfo)ELUtil.getBean("sessinfo"); 

48. sessinfo.setClient (client); 

LL 说 return "index"; 

50。 下 

SI。 


SessionInfo. java( 代 码 清单 4-16) 是 一 个 会 话 作 用 域 的 受 管 bean ,其 client 属性 用 于 存 
储 当前 会 话 期 已 登录 的 用 户 对 象 。 若 client 属性 的 值 为 null, 表 示 当 前 会 话 期 用 户 没 有 登录 。 
代码 清单 4-16 受 管 bean(SessionInfo. java) 


. Package bean; 

. import entity.Client; 

. import java.io.Serializable; 

. import javax.annotation.PreDestroy; 

。 import javax.faces .bean.ManagedBean; 

. import javax.faces .bean.SessionSscoped; 


. import model .ClientManager; 
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9. @ManagedBean (name="sessinfo") 
10. @SessionScoped 
11. public class SessionInfo implements Serializable { 
12. private Client client; 


13. public Client getClient (){ 


14. return client; 

15。 小 

16. Ppublic void setClient (Client client){ 
17. this.client=client; 

8, } 


19. @PreDestroy 
20. public void shutdown (){ 


2 if(client!=null){ 

25 ClientManager cm=new ClientManager () 7 
ph cm.logoff (client); 

24. } 

之 本 

26 下 


4.11.3 创建 JSF 页 面 


该 应 用 共有 三 个 JSF 页 面 : index. xhtml login. xhtml 和 registry. xhtml 。 

主页 index. xhtml( 代 码 清 单 4-17) 显示 注册 人 数 和 在 线 人 数 。 另 外 ,如 果 当 前 会 话 期 
用 户 没有 登录 ,页 面 会 显示 “登录 ”和 “注册 ” 超 链 接 , 单 击 它们 可 以 分 别 导航 至 相应 的 页 面 ， 
进行 登录 或 注册 。 如 果 当 前 会 话 期 用 户 已 经 登录 , 则 显示 用 户 名 和 "退出 ? 超 链接 。 

代码 清单 4-17 主页 (index. xhtml) 


1.<?xml version='1.0' encoding= 'UTF-8' ?> 
2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
3 "http://www.w3.0rg/TR/xhtml1l/DTD/xhtmll-transitional.dtd"> 
4. <html xmlns="http://www.w3.0rg/1999/xhtml" 
xmlns:h="http://java.sun.com/jsf/html"> 
6 <h:head> 
7 <title> 轻 松 论坛 -- 主 页 </title> 
8 </h:head> 
9. <h:body> 
10. <h:form> 
11。 <P> 
有 <h:outputText value= "注册 人 数 :# {index.numOfClient},"/> 
3 <h:outputText value= "在 线 人 数 :# {index.numofonline}"/> 
14. </p> 
15. <p> 
6。 <h:commandLink value= "登录 " action="login" 
Ey rendere "# {sessinfo.client==nu11}"/> 
18. <h:outputText value=" "/> 


19;, 
20。 
21。 
225 
23。 
24. 
25s 
26. 
27, 
28. 


<h:commandLink value= "注册" action="registry" 
rendered="# {sessinfo.client==nul1}"/> 


<h:outputText value="#{sessinfo.client.username}:" 


rendered="#{sessinfo.client!=nul1}"/> 


<h:commandLink value= "退出" action="# {index.exit}" 


rendered="#{sessinfo.client!=nul1}"/> 
</p> 
</h:form> 
</h:body> 
</html> 


登录 页 面 login. xhtml( 代 码 清单 4-18) 为 用 户 提供 登录 界面 。 如 果 登 录 失 败 , 会 显示 错 
误 消息 ;如 果 登 录 成 功 , 会 自动 导航 至 主页 。 另 外 , 单 击 “ 新 用 户 注 册 ” 超 链接 ,可 导航 至 注册 


页 面 。 


代码 清单 4-18 ”登录 页 面 (login. xhtml) 


9 
10. 
11。 
12 . 
13。 
14. 
15 。 
16. 
17。 
18 . 
9， 
20 
2 
22。 
23 
24. 
25. 
26. 
27. 
28 . 
和 29 
30. 
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1 
2 
3 
4. 
5 
6 
7 
8 


,<?xml version='1.0' encoding= 'UTE-8' ?> 
» < !DOCTYPE htm] PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 


"http://www.w3.0rg/TR/xhtml1l/DTD/xhtmll-transitional .dtd"> 
<html xmlns="http://www.w3.0rg/1999/xhtml" 
xmlns:h="http://java.sun.com/jsf/html"> 
<h:head> 
<title> 轻 松 论坛 登录 </title> 
</h:head> 
<h:body> 
<p> 


"请 登录 :"/> 


<h:outputText value: 
</p> 
<h:form id="fi"> 
<h:outputLabel for="username" accesskey="n"> 
用 户 名 (<u>n< /u>) 
</h:outputLabel> 
<h:inputText id="username" value="#{login.name}" size="15" maxlength="15" 
required="true" requiredMessage=" 用 户 名 为 必 填 项 " styleClass="field1"/> 
<h:message for="username" styleClass="font4"/> 
<br/> 
<h:outputLabel for="password" accesskey="p"> 
密 码 (<u>p</u>) 
</h:outputLabel> 


<h:inputSecret i 
required="true" requiredMessage=" 密 码 为 必 填 项 " styleclass="fieldl"/> 


<h:message for="password" styleClass="font4"/> 


"password" value="# {login.Pwj" size="15" maxlength="15" 


<p> 
<h:outputLink value="faces/registry.xhtml"> 新 用 户 注册 </h:outputLink> 
gnbsp; gnbsp; 


<h:commandButton id="submit" value=" 登 录 " action="#{login.login}"/> 


本 1 </p> 
32: </h:form> 
33. </h:body> 
34. </html> 


注册 页 面 registry. xhtml( 代 码 清 单 4-19) 为 用 户 提供 注册 界面 。 如 果 注 册 失 败 ,会 显 


示 错 误 消息 ;如 果 注 册 成 功 , 则 该 用 户 自动 成 为 已 登录 用 户 , 并 导航 至 主页 。 
代码 清单 4-19 registry. xhtml 


1. <?xml version='1.0' encoding= 'UTF-8' ?> 
.<1!DOCTYPE htm1l PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
.<html xmlns="http://www.w3.0rg/1999/xhtml" 
xmlns:h="http://java.sun.com/jsf/html" 
xmlns:f="http://java.sun.com/jsf/core"> 
<h:head> 
<title> 轻 松 论坛 -- 注 册 </title> 
9. </h:head> 
10. <h:body> 
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11, <p> 

Fr <h:outputText value=" 请 输入 你 的 信息 

3s </p> 

14. 

15 

16. <h:inputText id="username" value="#{registry.client.username}" 
Es required="true" requiredMessage=" 用 户 名 为 必 填 项 " 

18 . size="10" maxlength="15"/> 

19. <h:message for="username"/> 

20 。 <br/> 

2 密 码 

22. <h:inputSecret id="password" value="#{registry.client.password}" 
23, required="true" requiredMessage=" 密 码 为 必 填 项 " 

24. size="10" maxlength="15"/>* 

255 <h:message for="password"/> 

26. <br/> 

六 确认 密码 

2 <h:inputSecret id="passwordl" value="#{registry.passwordl1}" 
29， required="true" requiredMessage= "密码 为 必 填 项 " 

30. size="10" maxlength="15"/>* 

上 <h:message for="password1"/> 

I <br/> 

33, 性 ” 别 

34. <h:selectOneMenu id="gender" value="#{registry.client.gender}"> 
25: <f:selectItem itemLabel=" 男 " itemValue=" 男 "/> 

36, <f:selectItem itemLabel=" 女 " itemValue=" 女 "/> 

37， </h:selectOneMenu> 


38。 <br/> 


39. 文化 程度 

40. <h:selectOneMenu id="degree" hideNoSelectionOption="true" 
41. value="# {registry.client.degree}"> 

2 <f:selectItem itemLabel=" 请 选择 ..." noSelectionOption="true"/> 
43. <f:selectItem itemLabel=" 高 中 或 以 下 " itemValue= "1"/> 

44. <f:selectItem itemLabel=" 大 专 " itemValue="2"/> 

45. <f:selectItem itemLabel=" 本 科 " itemValue="3"/> 

46. <f:selectItem itemLabel=" 硕 士 " itemValue="4"/> 

47 . <f:selectItem itemLabel=" 博 士 或 博士 后 " itemValue="5"/> 

48 . </h:selectOneMenu> 

49。 <br/> 

50. 电子 邮箱 

Shs <h:inputText id="email" value="#{registry.client.email}" 
52. required="true" requiredMessage="email 为 必 填 项 " 

53% size="25" maxlength="25"/>* 

54. <h:message for="email"/> 

55, <p> 

56. <h:commandButton type="reset" value=" 重 置 "/> 

S75 &nbsp; 

5 &nbsp7 

59 。 <h:commandButton value=" 提 交 " action="#{registry.registry}"/> 
60. </p> 

61. </h:form> 

62. </h:body> 

63. </html> 


4.12 小 结 


基于 Facelets 技术 的 JSF 页 面 是 一 个 XHTML 页 面 , 其 文件 扩展 名 为 . xhtml。 
。 JSF 页 面 主要 由 JSF 标记 组 成 ,也 可 包含 普通 的 HTML 标记 、 某 些 JSTL 标记 。 
JSF 标记 包括 JSF HTML 标记 、JSF 核心 标记 、JSF Facelets 标记 、JSF 复合 标记 。 
。 JSF 核心 标记 通常 执行 一 些 与 任何 特定 的 呈现 包 无 关 的 核心 动作 。 
每 个 JSF HTML 标记 代表 某 种 UIComponent 组 件 与 JSF 框架 的 HTML 呈现 包 中 
某 个 呈现 器 的 一 种 组 合 。 
。 绝 大 多 数 JSF HTML 标记 的 标记 名 都 由 两 部 分 组 成 ,前 半 部 分 是 相应 组 件 类 的 组 
件 族 名 ,后 半 部 分 是 相应 呈现 器 的 型 名 。 
。 JSF HTML 标记 包括 以 下 几 种 。 
基本 输入 类 : h:inputText\h:inputSecret\h:inputTextArea、h:inputHidden 。 
基本 输出 类 : h:outputText、h:outputLabel、h:outputLink、h:outputFormat。 
图 像 : h:graphicImage。 
动作 类 : h:commandButton、h:commandLink。 
90 。 


二 选 一 : h:selectBooleanCheckbox。 
单 选 类 : h:selectOneRadio、h:selectOneMenu.h:selectOneListbox。 
多 选 类 : h:selectManyCheckbox、h:selectManyMenuh:selectManyListbox。 
消息 : h:message。 
消息 组 : h:messages。 
。 在 JSF 中 ,一 个 消息 表示 为 一 个 FacesMessage 实例 。 每 个 消息 主要 包括 概要 文本 、 
详细 文本 和 严重 级 别 三 个 属性 。 


习 题 4 


1. 简 述 JSF HTML 标记 与 普通 的 HTML 标记 之 间 的 关系 。 

2. 分 别 比较 下 面 各 组 标记 中 各 标记 的 主要 功能 。 

(1) h:inputText\h:inputSecret 

(2) h:outputText,h:outputLabel 

(3) h:outputLink,h:commandLink 

(4) h:commandButton.\h:commandLink 

(5) h:select ManyMenu,h:select ManyListbox 

(6) h:message\h:messages 

3. 解释 下 面 各 组 属性 的 作用 及 其 适用 的 标记 。 

(1) value binding 

(2) id for 

(3) style styleClass 

(4) title label 

(5) action ,actionListener 

(6) rendered readonly disabled 

4. 在 服务 器 端 Java 代码 中 ,如 何 获 取 当 前 视图 的 某 个 组 件 实例 ? 
5. 创建 JSF 应 用 sh4_logandreg。 该 应 用 包括 3 个 JSF 页 面 .若干 受 管 bean 类 和 模型 


类 ,实现 登录 和 注册 功能 。 请 按 下 列 步骤 完成 应 用 开发 。 


完善 


(1) 在 “ 源 包 ”中 分 别 创建 4 个 Java 包 : bean .entity ,model 和 util 。 
(2) 在 entity 包 中 创建 一 个 表示 客户 的 Java 类 Client。 下 面 是 该 类 的 不 完整 代码 ,请 


public class Client { 


private String username; // 用 户 名 (每 个 用 户 的 用 户 名 是 唯一 的 ) 
private String password; // 密 码 

private String realname; // 真 实 姓名 

private char sex; // 性 别 

private String phone; // 电 话 

private String email; // 邮 箱 地 址 

private String address; // 通 信和 地址 
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public Client (){} 

public Client (String username){ 
// 初 始 化 实例 变量 

} 

Public Client (String username,String password,String realname,char sex, 
String email){ 
// 初 始 化 实例 变量 

本 

// 为 各 实例 变量 提供 相应 的 getter 和 setter 方 法 

于 


(3) 在 model 包 中 创建 一 个 DataBase 类 ,用 于 存放 客户 数据 。 下 面 是 该 类 的 不 完整 代 
码 ,请 完善 之 。 


Public class DataBase { 
Private static final Map<String,Client>clients=new HashMap<String,Client> () 7 
六 时 
// 初 始 化 clients: 添加 1 至 若干 个 客户 
} 
public static Map<String,Client>getClients(){ 


return clients; 


} 


(4) 在 util 包 中 创建 一 个 Java 类 ELUtil, 其 中 定义 两 个 实用 的 静态 方法 。 下 面 是 该 类 
的 软件 接口 ,请 实现 之 (参见 第 4. 11 节 例子 ) 。 
Public class ELUtil { 
// 方 法 接收 一 个 EL 表达 式 字 符 串 ,计算 并 返回 表达 式 的 值 
public static Object evalEL (String el); 
// 方 法 接收 一 个 受 管 bean 的 名 称 ,返回 该 bean 的 引用 
public static Object getBean (String name) 7 


} 


(5) 在 model 包 中 创建 一 个 实现 客户 管理 业务 的 ClientManager 类 。 下 面 是 该 类 的 软 
件 接口 ,请 实现 之 。 
public class ClientManager { 
// 根 据 用 户 名 返回 相应 的 客户 。 如 果 不 存在 相应 的 客户 ,返回 nul1 
public Client findClientByName (String name); 
// 新 添加 一 个 客户 ,如 果 客 户 已 存在 .或 其 他 原因 无 法 完成 添加 ,返回 false 
public boolean insertClient (Client client) 7 
} 


(6) 在 bean 包 中 创建 一 个 受 管 bean: 名 称 为 sessionBeanl .类 名 为 bean. SessionBeanl 、 作 
用 域 为 会 话 作 用 域 。bean 类 中 定义 一 个 可 读 写 的 Client 型 属性 client。 该 属性 表示 当前 会 
话 期 登入 的 客户 ,如 果 没 有 客户 登录 ,该 属性 应 为 null。 
家 


(7) 创建 JSF 页 面 mdex. xhtml( 欢 迎 页 面 或 主页 ) ,以 及 相应 的 请 求 作 用 域 .类 名 为 
bean. Index 的 受 管 bean。 页 面 的 运行 效果 如 图 4-6 所 示 。 


》 登录 与 注册 一 主页 - Wozilla Firefox 。” 翁 | 回 | 区 | 》 登录 与 注册 一 主页 ~ Hozilla Firefox 革 ] 加 |] 区 | 
文件 四 编辑 E) 查看 历史 GE) 书签 多 I 上 站 文件 四 编辑 E) 查看 WW 历史 G) 书签 @) I 具 四 


< 


- 回 http://localhost:B080/sh4_logandres/ [| [| € - BB -| http://localhost:8080/sh4_logandree/ | 可 区 |] 


登录 注册 你 好 , 李 明 ! 退出 


完成 


图 4-6 ”欢迎 页 面 呈现 效果 


其 中 : 
(a) 是 客户 未 登录 时 的 显示 效果 , 单 击 * 登 录 ” 超 链接 将 转 至 登录 页 面 login. xhtml; 单 


jl 
Hr 
性 


E 册 ” 超 链 接 将 转 至 注册 页 面 registry. xhtml。 


(b) 是 客户 已 登录 时 的 显示 效果 ,其 中 “ 李 明 ” 是 登录 客户 的 真实 姓名 。 单 击 “ 退 出 ” 按 
钮 将 使 客户 退出 登录 状态 ,并 重新 显示 该 页 面 。 

(8) 创建 登录 页 面 login. xhtml, 以 及 相应 的 请 求 作用 域 、 类 名 为 bean. Login 的 受 管 
bean。 页 面 的 运行 效果 如 图 4-7(a) 所 示 。 


Mozilla Fir... 攻 | 扣 | 民 


文件 中) 编辑 FE) 查看 WW) 历史 G) 文件 四 忽 弗 中 查看 历史 G) 书签 @ 工具 四 帮助 0 


人 


-| 口 wep:/ieeahes [ol 十 - - [© http://leeahest:80601sh_legwnireg/ faces/registry xhtml [了 | >| 
a 


新 用 户 ?请 注册 , 不想 警 录 , 请 返回 首页 已 注册 ?请 登录 ， 故 弃 注 册 , 请 返回 首页 


请 登录 . . . 请 注册 .. . 
的 * 项 为 必 坪 项 ， 请 认真 填写 )) 
用 户 名 iinine 


密 码 see 用 户 名 + 


密码 + 
[EE 再 答 定 码 # 


真实 姓名 *# 
性 别 * 名 男女 
联系 电话 
电子 邮箱 * 
通信 地 址 


单 击 “ 


图 4-7 登录 页 面 与 注册 页 面 


注册 ” 超 链接 ,将 直接 导航 至 注册 页 面 registry. xhtml; 单 击 “ 返 回首 页 ? 超 链 接 ， 


将 直接 导航 至 欢迎 页 面 index. xhtml。 

用 户 单 击 “确定 ”按钮 ,应 用 将 检查 用 户 输入 的 用 户 名 和 密码 是 否 正确 。 若 用 户 名 或 密 
码 不 正确 (如 为 空 , 用 命名 不 存在 、 密 码 不 正确 等 ) ,返回 本 页 面 并 显示 错误 信息 。 若 用 户 名 
或 密码 正确 , 先 获取 相应 的 Client 对 象 并 保存 到 sessionBeanl 中 的 client 属性 中 ,然后 导航 
至 欢迎 页 面 index. xhtml 页 面 。 
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(9) 创建 注册 页 面 registry. xhtml, 以 及 相应 的 请 求 作 用 域 、. 类 名 为 bean. Registry 的 受 
管 bean。 页 面 的 运行 效果 如 图 4-7(b) 所 示 。 

单 击 “ 登 录 ” 超 链接 ,将 直接 导航 至 登录 页 面 login. xhtml; 单 击 “ 返 回首 页 ” 超 链接 ,将 直 
接 导 航 至 欢迎 页 面 index. xhtml。 

单 击 “ 提 交 ” 命 令 按 钮 时 ,应 用 将 检查 用 户 输入 的 信息 是 否 正确 。 若 用 户 输入 的 信息 不 
正确 (如 必 填 项 为 空 ) ,返回 本 页 面 并 显示 相应 的 错误 信息 。 若 用 户 输入 的 信息 正确 , 先 创建 
相应 的 Client 对 象 , 并 添加 至 DataBase 类 的 clients 属性 中 和 保存 到 sessionBeanl 中 的 
client 属性 中 ,然后 导航 至 欢迎 页 面 index. xhtml。 

注意 : 该 项 目 不 需 要 太 关 注 页 面 的 外 观 , 只 需 完 成 相应 的 功能 即 可 。 可 以 在 学 完 
第 6 章 后 再 来 完善 页 面 的 布局 和 格式 。 
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第 5 章 页 面 导 航 


本 章 主题 : 

。 导航 处 理 及 相关 组 件 

。 隐 式 导航 

。 导航 规则 及 基于 导航 规则 的 导航 
。 重 定向 

。h:link 与 h:button 标记 

。 视图 参数 与 可 书签 化 URL 


对 于 一 个 Web 应 用 来 说 ,页 面 导 航 的 设计 好 坏 直接 影响 用 户 对 应 用 的 访问 效率 。 从 
JSF 1.2 到 JSF 2.0,JSF 提供 的 页 面 导 航 技术 有 了 很 多 的 扩充 。 从 原先 根据 用 户 动 作 和 业 
务 逻 辑 确定 目标 视图 的 POST 请 求 ,到 新 的 面向 视图 参数 和 目标 视图 的 GET 请 求 ,本 章 将 
对 它们 做 详细 介绍 。 


5.1 导航 概述 


在 Web 应 用 中 ,所 谓 导 航 是 指 通过 在 页 面 上 放置 超 链接 或 递交 按钮 ,使 访问 者 可 以 快 
速 地 从 一 个 页 面 (视图 ) 转 至 另 一 个 页 面 (视图 )。 合 适 的 导航 能 够 方便 访问 者 访问 其 所 需 的 
信息 或 请 求 相关 的 业务 处 理 。 

导航 处 理 是 指 根据 当前 请 求 的 上 下 文 状态 信息 确定 目标 页 面 (视图 ) 的 过 程 。 在 JSF 
中 ,导航 处 理由 导航 处 理 器 (NavigationHandler) 完 成 ,下 面 组 件 涉 及 导航 处 理 : 

。 h:commandButton( 动 作 按钮 ); 

。 h:commandLink( 动 作 超 链接 ); 

。 h:button( 结 果 按 钮 ) ; 

。 hi:link( 结 果 超 链接 ) 。 

对 于 动作 类 组 件 (h:commandButton 和 h:commandLink) ,导航 处 理发 生 在 用 户 发 出 
请 求 之 后 。 当 用 户 单 击 组 件 呈 现 的 按钮 或 超 链接 提交 请 求 时 ,将 触发 动作 事件 .调用 动作 方 
法 ,之 后 就 由 导航 处 理 器 确定 要 呈现 的 目标 视图 。 这 种 导航 处 理 也 称 为 后 置式 导航 处 理 。 

对 于 结果 类 组 件 (h:button 和 h:link) .导航 处 理发 生 在 页 面 呈 现 前 , 即 在 组 件 呈 现时 ， 
导航 处 理 器 就 会 确定 目标 视图 。 当 用 户 单 击 组 件 呈 现 的 按钮 或 超 链 接 时 ,将 直接 转 至 之 前 
已 确定 的 目标 视图 。 这 种 导航 处 理 也 称 为 前 置式 导航 处 理 。 

说 明 : h:outputLink 组 件 呈 现 的 普通 超 链 接 是 一 种 基本 的 导航 技术 ,但 其 目标 页 面 是 
在 标记 中 直接 指定 的 ,所 以 并 不 需要 JSF 导航 处 理 器 进行 导航 处 理 。 

无 论 是 后 置式 导航 处 理 还 是 前 置式 导航 处 理 , 其 处 理 算法 是 一 致 的 。 导 航 处 理 器 根据 
结果 值 . 并 结合 其 他 上 下 文 状 态 信息 进行 导航 处 理 。 下 面 是 导航 处 理 中 会 涉及 的 几 个 主要 
术语 。 
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1. 动作 值 (action value) 

动作 组 件 的 action 属性 值 本 身 ,可 以 是 一 个 EL 方法 表达 式 ,也 可 以 是 一 个 简单 的 字符 
串 文字 。 

2. 结果 值 (outcome value) 

是 导航 处 理 器 进行 导航 处 理 的 主要 依据 。 结 果 值 的 可 能 情况 包括 : 

。 动作 组 件 的 action 属性 指定 的 字符 串 文字 。 

。 动作 组 件 的 action 属性 指定 的 EL 方法 表达 式 的 计算 结果 。 

。 结果 组 件 的 outcome 属性 指定 的 字符 串 文字 。 

。 结果 组 件 的 outcome 属性 指定 的 值 表达 式 的 计算 结果 。 

3. 视图 ID(view ID) 

以 “/” 开 头 、 相 对 于 应 用 上 下 文 路 径 的 视图 (页 面 )URL。 

说 明 : 

(1) 这 里 ,action 是 h: commandButton 组 件 标记 和 h:commandLink 组 件 标 记 的 一 个 
属性 ,而 outcome 是 h:button 组 件 标记 和 h:link 组 件 标记 的 一 个 属性 。 

(2) 对 于 后 置式 导航 处 理 , 若 action 属性 指定 的 是 简单 的 字符 串 文字 , 则 其 动作 值 与 结 
果 值 是 相同 的 。 

(3) 对 于 前 置式 导航 处 理 , 不 牵涉 动作 值 。 


5.2 隐 式 导航 


隐 式 导航 是 JSF 2.0 新 引入 的 特性 ,是 指 在 开发 人 员 没 有 指定 相应 的 导航 规则 时 ,导航 
处 理 器 所 进行 的 导航 处 理 。 

当 未 定义 导航 规则 或 没有 匹配 的 导航 规则 时 ,JSF 框架 的 导航 处 理 器 将 把 结果 值 看 作 
是 目标 视图 的 视图 ID。 如 果 结 果 值 不 以 "/ "开头 , 则 在 其 前 添加 源 视 图 相对 于 应 用 上 下 文 
路 径 的 路 径 。 如 果 结 果 值 不 包含 文件 扩展 名 , 则 在 其 后 添加 源 视图 的 文件 扩展 名 。 

例如 , 源 视图 (/login. xhtml) 的 表单 中 包含 如 下 的 命令 按钮 标记 : 


<h:commandButton id="cm" value="OK" action="response"/> 


当 用 户 单 击 该 按钮 时 ,将 会 导航 至 视图 ID 为 /response. xhtml 的 目标 视图 。 这 里 ,虽然 
导航 处 理 器 参与 了 导航 处 理 , 但 导航 处 理 确定 的 目标 页 面 视图 总 是 某 个 固定 的 页 面 视 图 。 
又 例如 , 源 视图 (/login. xhtml) 的 表单 中 包含 如 下 的 命令 按钮 标记 : 


<h:commandButton id="cm" value="OK" action="#{login.isUser}"/> 
login 引用 一 个 受 管 bean,bean 类 必须 包含 一 个 isUser 方法 。 


public String isUser(){ 
E(t // 验 证 成 功 
return "success"; 
} else { // 验 证 失败 
return "failure"; 
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中 


若 验 证 成 功 , 将 会 导航 至 视图 ID 为 /success. xhtml 的 目标 视图 。 若 验证 失败 ,将 会 导 
航 至 视图 ID 为 /failure. xhtml 的 目标 视图 。 这 里 ,导航 处 理 确定 的 目标 页 面 视 图 不 仅 取决 
于 用 户 单 击 了 哪个 按钮 或 超 链接 ,也 取决 于 当前 请 求 的 其 他 上 下 文 状态 信息 ,从 而 会 导航 至 
不 同 的 目标 页 面 视图 。 这 种 导航 称 为 动态 导航 。 

隐 式 导航 的 特点 是 不 需要 指定 导航 规则 ,目标 视图 ID 由 结果 值 直接 指定 。 这 种 导航 方 
式 的 优点 是 简单 .直接 ,易于 理解 ;缺点 是 不 能 对 整个 应 用 的 导航 模型 进行 集中 管理 ,不 便于 
维护 。 

隐 式 导航 不 仅 可 以 实现 静态 导航 ,也 可 以 实现 动态 导航 :不仅 适 用 于 后 置式 导航 ,也 适 
用 于 前 置式 导航 。 


5.3 基于 导航 规则 的 导航 


当 导 航 处 理 器 进行 导航 处 理 时 ,首先 寻找 匹配 的 导航 规则 。 如 果 存 在 匹配 的 导航 规则 ， 
将 依据 导航 规则 确定 目标 页 面 视图 。 


5.3.1 导航 规则 


导航 规则 由 navigation-rule 元 素 及 其 子 元 素 在 /WEB-INFVfaces-config. xml 或 其 他 自 
定义 的 Faces 配置 文件 中 声明 。 下 面 是 一 个 导航 规则 的 声明 示例 。 


<navigation-rule> 
<from-view-id>/index.jsp</from-view-id> 
<navigation-case> 
<from-action>#{login.isUser}</from-action> 
<from-outcome>ok</from-outcome> 
<if>#{login.valid}</if> 
<to-view-id>/success.xhtml</to-view-id> 


</navigation- case> 


</navigation-rule> 


其 中 : 

(1) 每 一 个 Faces 配置 文件 可 以 包含 多 个 navigation-rule 元 素 ,每 个 navigation-rule 元 
素 声明 一 个 导航 规则 。 

(2) 每 一 个 navigation-rule 元 素 可 以 包含 一 个 可 选 的 from-view-id 子 元 素 , 另 外 可 以 
包含 多 个 navigation-case 子 元 素 ,每 个 navigation-case 元 素 声明 一 个 导航 案例 。 

(3) 每 一 个 navigation-case 元 素 可 以 包含 一 个 可 选 的 from-action 子 元 素 ,一 个 可 选 的 
from-outcome 子 元 素 、 一 个 可 选 的 庄子 元 素 , 另 外 需要 包含 一 个 必 选 的 to-view-id 子 元 素 。 

下 面 是 上 述 一 些 元 素 的 含义 及 作用 。 

from-view-id: 用 于 指定 适用 该 导航 规则 的 源 页 面 视图 的 视图 ID。 如果 未 指明 该 元 素 ， 
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一 个 导航 规则 将 适用 于 所 有 页 面 视 图 。 一 个 页 面 视图 的 所 有 导航 案例 可 以 定义 在 一 个 导航 
规则 里 ,也 可 以 分 散 定义 在 多 个 导航 规则 里 。 

from-outcome: 用 于 指定 适用 该 导航 案例 的 结果 值 。 

from-action: 用 于 指定 动作 值 ( 即 动作 方法 表达 式 本 身 )。 源 于 同一 个 页 面 视图 的 多 个 
请 求 , 在 调用 各 自 的 动作 方法 后 可 能 会 产生 相同 的 结果 值 .此 时 可 以 通过 动作 值 区 分 它们 ， 
以 便 匹 配 不 同 的 导航 案例 。 

这 : 该 元 素 值 应 该 是 一 个 布尔 型 的 值 表达 式 , 用 于 指定 该 导航 案例 是 否 匹配 的 动态 条 件 。 

to-view-id: 用 于 指定 目标 页 面 视图 的 视图 ID。 


5.3.2 导航 算法 


导航 处 理 器 以 结果 值 为 参数 .导航 规则 和 导航 案例 为 依据 ,结合 当前 请 求 的 其 他 上 下 文 
状态 信息 进行 导航 处 理 。 下 面 是 导航 处 理 算法 一 个 大 致 描述 。 

(1) 导航 处 理 器 首先 会 依次 (在 配置 文件 中 从 上 到 下 ) 检 查 各 导航 规则 ,寻找 相 匹 配 的 
导航 规则 。 相 匹配 的 导航 规则 通常 是 指 其 from-view-id 元 素 内 容 为 源 视图 ID 的 导航 规则 。 

(2) 当 找 到 一 个 相 匹 配 的 导航 规则 时 ,导航 处 理 器 将 依次 检查 其 中 的 各 导航 案例 ,寻找 
相 匹 配 的 导航 案例 。 相 匹配 的 导航 案例 是 指 满足 下 面条 件 的 导航 案例 : 

。 如 果 包 含 from-action 元 素 ,其 内 容 应 等 于 动作 值 ; 

。 如 果 包 含 from-outcome 元 素 , 其 内 容 应 等 于 结果 值 ; 

。 如 果 包 含 计 元 素 , 其 指定 的 值 表 达 式 的 计算 结果 应 为 true。 

(3) 若 发 现 一 个 相 匹配 的 导航 案例 ,其 中 不 包含 if 元 素 , 则 : 

。 若 结果 值 为 非 null, 则 其 to-view-id 元 素 的 值 即 为 目标 视图 ID; 

。 若 结 果 值 为 null, 重 新 显示 源 视 图 。 

(4) 若 发 现 一 个 相 匹配 的 导航 案例 ,上 且 其 中 包含 计 元 素 , 则 不 管 结果 值 是 否 为 null, 其 
to-view-id 元 素 的 值 即 为 目标 视图 ID。 

(5) 若 未 发 现任 何 匹配 的 导航 规则 及 导航 案例 ,而 结果 值 为 null, 则 重新 显示 源 视 图 。 

(6) 若 未 发 现任 何 匹配 的 导航 规则 及 导航 案例 ,而 结果 值 为 非 null, 则 进行 隐 式 导航 。 

说 明 : 只 有 当 结 果 值 为 null 且 不 包含 计 元 素 时 ,当前 视图 作用 域 才 会 延续 ;和 否则 在 导航 
处 理 后 ,一 个 新 的 视图 作用 域 将 产生 。 

也 可 以 在 WEB-INF 目录 下 创建 其 他 的 Faces 配置 文件 ( 非 faces-config. xml) ,然后 在 
其 中 声明 导航 规则 。 这 些 配置 文件 的 相对 于 应 用 上 下 文 路 径 的 路 径 列 表 ( 各 路 径 间 以 逗号 
分 隔 ) 应 作为 名 为 javax. faces. CONFIG_FILES 的 上 下 文 参数 的 初始 值 在 web. xml 文件 中 
指定 。 下 面 是 设置 该 上 下 文 参数 的 一 个 示例 。 


<context-param> 
<param-name>javax.faces.CONFIG FILES</param-name> 
<param-value> /WEB- INF/faces-config 1.xml,/WEB-INF/faces-config 2.xml 
</param-value> 


</context-param> 


当 存 在 多 个 Faces 配置 文件 时 ,导航 处 理 器 按 以 下 顺序 检查 各 Faces 配置 文件 中 的 导 
航 规则 和 导航 案例 : 
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。 上 下 文 参 数 javax. faces. CONFIG_FILES 的 值 中 指定 的 顺序 。 如 对 于 上 面 示例 , 导 
航 处 理 器 将 先 检查 faces-config_1. xml 配置 文件 中 的 导航 规则 和 导航 案例 ,然后 再 
检查 faces-config_2. xml 配置 文件 中 的 导航 规则 和 导航 案例 。 

。 /WEB-INFVfaces-config. xml 文件 。 该 配置 文件 中 的 导航 规则 和 导航 案例 会 被 最 后 
检查 ,即使 该 配置 文件 出 现在 javax. faces. CONFIG_FILES 上 下 文 参 数值 中 也 是 
如 此 。 


5.3.3 导航 规则 的 进一步 说 明 


这 里 对 导航 规则 的 一 些 特殊 情况 作 进一步 的 说 明 。 

1. 通配符 

一 个 导航 规则 的 from-view-id 元 素 的 内 容 可 以 以 通配符 * 结尾 。 此 时 ,判断 该 导航 规 
则 是 否 匹 配 的 条 件 是 指 该 元 素 内 容 的 前 缀 (* 之 前 的 内 容 ) 与 源 视图 ID 的 前 部 是 否 相 同 。 
若 存在 多 个 这 样 的 匹配 导航 规则 ,选择 匹配 前 绥 最 长 的 一 个 。 

假设 源 页 面 视 图 的 视图 ID 是 /subsys/group/page. xhtml,Faces 配置 文件 中 含 以 下 两 
个 导航 规则 : 


<navigation-rule> 
<from-view-id>/subsys/*</from-view-id> 
<navigation-case> 
</navigation-case> 

</navigation-rule> 

<navigation-rule> 
<from-view-id>/subsys/group/* </from-view-id> 
<navigation-case> 
</navigation-case> 


</navigation-rule> 


那么 这 两 个 导航 规则 都 适用 于 上 述 源 页 面 视图 引发 的 导航 ,但 后 面 一 个 导航 规则 更 恰 
当 , 因 为 其 匹配 的 前 缀 更 长 。 

车 一 个 导航 规则 的 from-view-id 元 素 的 内 容 仅 为 一 个 * ,或 者 根本 不 包含 该 元 素 , 则 该 
导航 规则 适用 于 任何 源 视图 引起 的 导航 处 理 。 

在 这 里 ,一 个 导航 规则 可 能 适用 于 多 个 页 面 视图 , 反 过 来 ,一 个 源 页 面 视图 也 可 能 存在 
多 个 相 匹配 的 导航 规则 。 对 于 一 个 具体 的 源 页 面 视图 ,到 底 采 用 哪个 导航 规则 ,一 要 看 哪个 
导航 规则 更 恰当 (视图 ID 匹配 前 绥 较 长 ) ,二 还 要 看 该 导航 规则 中 是 和 否 有 相 匹 配 的 导航 案 
例 。 也 就 是 说 ,如 果 最 恰当 的 导航 规则 中 没有 相 匹 配 的 导航 案例 ,那么 将 检查 另 一 个 相 匹配 
的 导航 规则 中 是 否 有 相 匹 配 的 导航 案例 。 

2. 动态 目标 视图 ID 

每 个 navigation-case 元 素 必 须 包 含 一 个 to-view-id 子 元 素 。 该 子 元 素 不 仅 可 以 直接 指 
定 目标 视图 ID, 也 可 以 指定 一 个 EL 值 表 达 式 。 后 种 情况 下 ,具体 的 目标 视图 ID 通过 计算 
EL 值 表 达 式 获得 。 例 如 : 

记 订 加 二 


<navigation-rule> 
<from-view-id>/main.xhtml</from-view-id> 
<navigation-case> 
<to-view-id>#{myBean.nextViewID}</to-view-id> 
</navigation-case> 


</navigation-rule> 


该 导航 规则 适用 于 源 自 视图 /main. xhtml 的 导航 。 当 导航 处 理 时 ,名 为 myBean 的 受 管 
Bean 的 getNextViewID( ) 方 法 被 调用 ,以 获取 目标 视图 ID。 


5.4 重 定 向 


当 用 户 单 击 动作 类 按钮 (h:commandButton) 或 超 链接 (h:commandLink) 时 会 产生 回 
送 (postback) 请 求 . 引 发 相应 组 件 的 动作 事件 。 在 处 理 回 送 请 求 的 “调用 应 用 ”阶段 ,动作 方 
法 被 调用 .并 产生 结果 值 , 然 后 导航 处 理 器 以 结果 值 为 参数 进行 导航 处 理 、 确 定 目标 页 面 视 
图 ,最 后 再 由 JSF 框架 将 目标 视图 呈现 给 用 户 。 这 一 过 程 的 直接 结果 是 : 浏览 器 窗口 中 显 
示 的 是 目标 视图 的 内 容 , 而 浏览 器 的 地 址 栏 中 仍 显 示 源 视图 的 URL。 在 很 多 情况 下 ,这 种 
不 一 致 是 不 适当 的 。 利 用 重 定向 技术 可 以 消除 这 种 不 一 致 。 

重 定向 是 由 服务 器 和 客户 端 浏 览 器 共同 完成 的 。 首 先 , 服 务 器 并 不 直接 将 目标 视图 的 
内 容 呈 现 给 客户 端 ,而 是 先 向 客户 端 发 送 一 个 HTTP 重 定向 响应 。 该 响应 仅 包含 状态 行 和 
响应 头 , 其 中 状态 码 为 302 ,表示 重 定向 ;响应 头 包括 Location 域 ,指定 重 定向 的 目标 视图 的 
URL。 其 次 ,浏览 器 接收 到 重 定 向 响应 后 ,会 自动 向 目标 页 面 发 出 请 求 ,这 一 过 程 并 不 需要 
用 户 的 介入 。 最 终 ,浏览 器 地 址 栏 中 显示 目标 视图 的 URL. 浏 览 器 窗口 中 显示 目标 视图 的 
内 容 。 

可 以 看 出 , 重 定向 比 原来 的 情况 多 了 一 个 “请 求 一 响应 ”过 程 ,所 以 响应 速度 会 变 慢 ,但 
它 可 使 浏览 器 上 显示 的 页 面 内 容 与 其 地 址 栏 中 的 URL 保持 一 致 。 

当 采 用 规则 导航 时 ,可 以 在 navigation-case 元 素 中 插入 redirect 子 元 素 ,要 求 JSF 框架 
重 定向 至 目标 视图 。 例 如 : 


<navigation-rule> 
<from-view-id>/login.xhtml</from-view-id> 
<navigation-case> 
<from-outcome>ok</from-outcome> 
<to-view-id>/index.xhtml</to-view-id> 
<redirect/> 
</navigation-case> 


</navigation-rule> 


如 果 采 用 隐 式 导航 ,可 以 在 结果 值 中 添加 一 个 名 为 faces-redirect、 值 为 true 的 请 求 参 
数 , 以 便 实现 重 定向 。 下 面 是 代码 示例 : 
<h:commandButton value=" 确 认 " action="index?faces-redirect=true"/> 


此 时 ,问号 (?) 前 面 的 index 被 取出 以 确定 目标 视图 ID, 而 faces 一 redirect 二 true 则 指 
» 100 。 


示 JSF 框架 重 定向 至 目标 视图 。 
5.5 h:link 与 h:button 标记 


h:link 标记 与 h: button 标记 统称 为 结果 类 标记 ,其 相应 组 件 类 有 共同 的 超 类 
UIOutcomeTarget, 在 该 超 类 中 定义 了 两 个 组 件 共 同 的 组 件 族 名 OutcomeTarget。 

结果 类 标记 组 件 在 呈现 时 ,都 会 先 根据 outcome 属性 计算 结果 值 ,然后 由 导航 处 理 器 
根据 结果 值 确定 目标 视图 。outcome 属性 值 可 以 是 表示 结果 值 的 字符 串 ,也 可 以 是 一 个 EL 
值 表达 式 ,结果 值 通过 计算 该 值 表达 式 获 得 。 

与 h:commandButton 和 h:commandLink 标记 不 同 ,结果 类 标记 h:link 和 h:button 不 
需要 置 于 h:form 标记 内 ,它们 不 会 收集 表单 数据 产生 回 送 请 求 。 结 果 类 标记 产生 直接 


5.5.1 h:link 


该 标记 在 服务 器 端 表示 为 一 个 HtmlOutcomeTargetLink 组 件 实例 。 组 件 呈 现 为 
HTML a 元素, 其 href 属性 值 为 为 导航 处 理 确定 的 目标 视图 的 URL。 

单 击 由 该 标记 呈现 的 超 链接 将 产生 一 个 对 目标 视图 的 直接 请 求 。 

标记 组 件 呈现 的 超 链接 的 文本 既 可 以 由 该 标记 组 件 value 属性 指定 ,也 可 以 由 嵌 套 的 
文本 或 h:outputText 标记 指定 ,或 者 由 骨 套 的 h:graphicImage 标记 指定 超 链接 图 像 。 


5.5.2 h:button 


该 标记 在 服务 器 端 表示 为 一 个 HtmlOutcomeTargetButton 组 件 实例 ,组 件 呈 现 为 
HTML input 元 素 。 默 认 情 况 下 ,input 元 素 的 type 属性 值 为 "button”, 即 产生 一 个 文本 按 
钮 ,标记 的 value 属性 值 指定 按钮 标题 。 若 为 标记 指定 了 image 属性 , 则 input 元 素 的 type 
属性 值 为 image”, 即 产生 一 个 图 像 按 钮 ,input 元 素 的 src 属性 值 为 标记 的 image 属性 指定 
的 图 像 资源 的 URL。 无 论 哪 种 情况 ,input 元 素 都 会 包含 一 个 onclick 属性 , 其 中 的 
JavaScript 代码 可 以 产生 超 链接 导航 行为 。 

单 击 由 该 标记 呈现 的 按钮 将 产生 一 个 对 目标 视图 的 直接 请 求 。 


5.5.3 常用 属性 


除了 outcome value 属性 以 及 id,render binding \title style styleClass 等 通用 属性 外 ， 
结果 类 标记 还 包含 下 面 一 些 常 用 属性 。 

(1) fragment: 用 于 指定 目标 页 面 某 个 位 置 ( 锚 点 ) 的 名 称 ,使 得 当 导 航 到 目标 页 面 时 能 
直接 定位 于 该 属性 指定 的 页 面 位 置 。 

(2) disabled: 该 属性 适用 于 h:link 标记 ,但 不 适用 h:button 标记 ,默认 值 为 false。 若 
设置 为 true,h:link 标记 组 件 将 呈现 为 HTML span 元 素 , 而 不 是 HTML a 元素 。 

(3) target: 该 属性 适用 于 h:link 标记 ,但 不 适用 h:button 标记 ,用 于 指定 目标 资源 打 
开 的 位 置 。 默 认 情 况 下 ,目标 资源 会 在 当前 窗口 打开 。 
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5.6 规则 导航 应 用 示例 


本 应 用 项 目 (ch5_navigation) 包 含 一 个 Faces 配置 文件 ,一 个 受 管 bean 类 和 三 个 JSF 
页 面 。 应 用 的 运行 效果 如 图 5-1 所 示 。 


[=] 导航 应 用 示例 一 响应 1 - Hozill--- 攻 加 | 区 | 
文件 E) 编辑 EE) 查看 (历史 G) 书签 四 ) 文件 四， 编 得 EF) 查看 W) 历史 G) 书签 所) 


全 -本 -|D wo:mieeuhstaoeordsr am 舍 -大 -| 昌 he:mloecahstceneo/dsr 上 
请 输入 一 个 正 整数 : 这 是 一 个 奇数 :1 


文件 EE) 编辑 FE) 查看 WM) 历史 G) 


这 是 一 个 偶数 :8 


图 5-1 应 用 ch5_navigation 运行 效果 


1. JSF 页 面 

该 应 用 共有 三 个 JSF 页 面 。 主 页 index. xhtml( 代 码 清单 5-1) 主要 包含 一 文本 域 和 三 
个 按钮 。“POST 请 求 "和 *PRG 请 求 "两 个 按钮 都 是 由 相应 的 h:commandButton 标记 产生 
的 “GET 请 求 " 则 是 由 h:button 标记 产生 的 。 

代码 清单 5-1 主页 (index. xhtml) 


.<?xml version='1.0' encoding= 'UTF-8' ?> 

.<“!DOCTYPE html PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1l/DTD/xhtmll-transitional.dtd"> 

.<html xmlns="http://www.w3.0rg/1999/xhtml" 


<h:head> 
<title> 导 航 应 用 示例 -- 主 页 < /title> 


1 
2 
区 
4 
5 xmlns:h="http://java.sun.com/jsf/html"> 
6 
7 
8 </h:head> 


9. <h:body> 


10. <h:form id="f"> 

LF <p><h:outputLabel for="i" value=" 请 输入 一 个 正 整 数 :"/>< /p> 

12, <p><h:inputText id="i" value="# {myBean.num}"/></p> 

9; <p><h:commandButton value="POST 请 求 "/>< /p> 

14. <p><h:commandButton value="PRG 请 求 " action="# {myBean.action}"/></p> 
15, </h:form> 

16. <p><h:button value="GET 请 求 "/>< /p> 


17. </h:body> 
18. </html> 


应 用 的 另外 两 个 页 面 分 别 是 responsel. xhtml 和 response2. xhtml。 这 两 个 页 面 的 功 
能 都 是 显示 受 管 bean 中 num 属性 的 值 ,其 中 responsel. xhtml( 代 码 清单 5-2) 只 是 当 num 
属性 值 为 奇数 时 才 被 呈现 ,而 response2. xhtml( 代 码 清单 5-3) 则 是 当 num 属性 值 为 偶数 时 
才 被 呈现 。 之 所 以 引入 两 个 响应 页 面 而 非 一 个 响应 页 面 ,完全 是 为 了 说 明 导 航 过 程 的 需要 。 
代码 清单 5-2 responsel. xhtml 
1.<?xml version='1.0' encoding= 'UTE-8' ?> 


2. <!DOCTYPE html PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 
3. "http://www.w3.0org/TR/xhtml1l/DTD/xhtmll-transitional.dtd"> 


4. <html xmlns="http://www.w3.0rg/1999/xhtml" 

5 xmlns:h="http://java.sun.com/jsf/html"> 
6. <h:head> 

次 <title> 导 航 应 用 示例 -- 响 应 1< /title> 

8 </h:head> 

9 <h:body> 
10. <p> 这 是 一 个 奇数 :# {myBean.num}< /p> 
Yh <h:link value=" 返 回 主页 " outcome="index"/> 
12. </h:body> 
13. </html> 


代码 清单 5-3 response2. xhtml 


. <?xml version='1.0' encoding= 'UTF-8' ?> 

.<“!DOCTYPE html PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 

.<html xmlns="http://www.w3.0rg/1999/xhtml" 


1 
2 
3 
4 
5 xmlns:h="http://java.sun.com/jsf/html"> 
6 <h:head> 

7 <title> 导 航 应 用 示例 -- 响 应 2< /title> 

8 </h:head> 

9. <h:body> 

10. <p> 这 是 一 个 偶数 :# {myBean.num}< /p> 

EN <h:link value=" 返 回 主 页 " outcome="index"/> 
12. </h:body> 

13. </html> 


两 个 响应 页 面 中 的 “返回 主页 ” 超 链接 都 由 h:link 标记 产生 , 且 都 采用 静态 的 隐 式 导 
航 。 下 面 主要 讨论 由 主页 到 响应 页 面 的 导航 过 程 。 

2. 导航 过 程 分 析 

由 主页 到 响应 页 面 的 导航 采用 动态 的 规则 导航 。 

首先 给 出 应 用 中 唯一 的 受 管 bean 类 的 代码 (代码 清单 5-4) ,因为 其 中 的 一 些 方法 和 属 
性 会 在 导航 规则 中 被 引用 。 其 中 ,getValid() 方 法 判断 num 属性 值 是 否 有 效 , 即 若 属 性 值 为 
正 整 数 , 返 回 true, 和 否则 返回 false;getNextViewID() 方 法 用 于 动态 计算 目标 视图 ID。 

。 103 。 


代码 清单 S-4 受 管 bean(MyBean. java) 


. Package bean; 
. Public class MyBean { 


public int getNum(){ 


1 

4 

3 

4 

5. private int num=1; 
6 

弄 return num; 
8 


} 
9. public void setNum(int num){ 
10. this.num=num; 
311。 } 
12。 
13. Ppublic String getNextViewID(){ 
14. System.out.println (num); 
25。 if (num%2==0){ 
16. return "/response2.xhtml"; 
3 } else { 
18. return "/responsel .xhtml"; 
E95 
20 .。 } 
21. public boolean getvalid(){ 
2 return num>=1; 
23。 $ 
24. public String action(){ 
25。 return null; 
26。 } 
27..} 


然后 给 出 应 用 的 Faces 配置 文件 内 容 ( 代 码 清单 5-5) ,其 中 包含 受 管 bean 的 声明 和 导 
航 规则 的 声明 。 
代码 清单 5-5 faces-config. xml 


1. <?xml version='1.0' encoding='UTF-8'?> 


2. <faces-config version="2.0" 
3 xmlns="http://java.sun.com/xml/ns/javaee" 
4 xmlns:xsi="http://www.w3.0rg/2001/XMLSchema- instance" 
5. xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
6 http://java.sun.com/xml/ns/javaee/web-facesconfig 2 0.xsd"> 
7 <managed-bean> 
8 <managed-bean-name>myBean< /managed-bean- name> 
ds <managed-bean-class>bean.MyBean< /managed-bean-class> 
10. <managed-bean-scope>session</managed-bean- scope> 
11.。 </managed-bean> 
12. <navigation-rule> 
3 <from-view-id>/index.xhtml</from-view-id> 


14. <navigation-case> 


5 <from-action>#{myBean.action}</from-action> 

Eb <if># {myBean.valid}</if> 

Le <to-view-id>#{myBean.nextViewID}</to-view-id> 
0 <redirect/> 

EE </navigation-case> 

20s <navigation-case> 

2 <if>#{myBean.valid}</if> 

225 <to-view-id># {myBean.nextViewID}</to-view-id> 
-人 </navigation-case> 

24. </navigation-rule> 


25. </faces-config> 


最 后 分 析 由 主页 到 响应 页 面 的 导航 过 程 。Faces 配置 文件 仅 定义 了 一 个 导航 规则 , 它 
适用 于 源 自 主页 (index. xhtml) 的 导航 。 

该 导航 规则 包含 两 个 导航 案例 。 在 受 管 bean 的 valid 属性 值 为 true 的 情况 下 ,前面 那 
个 导航 案例 适用 于 “PRG 请 求 "按钮 的 导航 ,后 面 那个 导航 案例 使 用 于 “POST 请 求 ” 和 
“GET 请 求 ” 按 钮 的 导航 。 

这 两 个 导航 案例 的 次 序 不 能 颠倒 ,否则 带 from-action 元 素 的 导航 案例 将 失效 ,三 个 按 
钮 都 将 采用 不 带 from-action 元 素 的 导航 案例 进行 导航 。 

下 面 对 三 个 按钮 的 导航 进行 逐一 讨论 。 

当 在 文本 域 中 输入 一 个 整数 、 并 按 “POST 请 求 ”按钮 ,将 产生 一 个 POST 请 求 ,输入 的 值 
被 保存 到 受 管 bean 的 num 属性 中 。 在 导航 处 理 时 ,如 果 受 管 bean 的 valid 属性 值 为 true( 即 
num 属性 值 为 正 整数 ) ,将 找到 合适 的 导航 案例 , 即 后 面 那个 导航 案例 。 目 标 视 图 ID 将 通过 计 
算 EL 值 表达 式 # {myBean. nextViewID} 获得 , 即 若 num 属性 值 为 奇数 , 则 目标 视图 ID 为 / 
responsel. xhtml ,否则 目标 视图 ID 为 /response2. xhtml。 如 果 受 管 bean 的 valid 属性 值 为 false 
( 即 num 属性 值 不 是 正 整数 ), 则 找 不 到 合适 的 导航 案例 ,此 时 将 重新 显示 主页 。 

当 在 文本 域 中 输入 一 个 整数 、 并 按 “PRG 请 求 ”按钮 时 ,总 体 情况 与 按 “"POST 请 求 ” 按 
钮 时 的 一 样 ,所 不 同 的 是 : 当 找 到 合适 的 导航 案例 (前 面 那 个 ) 、 并 计算 出 目标 视图 ID 后 ,并 
不 是 直接 呈现 目标 视图 ,而 是 产生 一 个 重 定向 (REDIRECT) 响 应 ,然后 由 客户 端 浏览 器 发 
出 对 目标 视图 的 GET 请 求 。 

与 上 述 两 个 按钮 不 同 ,“GET 请 求 ” 按 钮 的 导航 处 理 是 在 页 面 呈现 前 进行 的 。 在 导航 处 
理 时 ,如 果 受 管 bean 的 valid 属性 值 为 true, 将 找到 合适 的 导航 案例 (后 面 那个 ) 。 目 标 视图 
ID 将 通过 计算 EL 值 表 达 式 #{myBean. nextViewID} 获 得 。 如 果 受 管 bean 的 valid 属性 值 
为 false, 则 找 不 到 合适 的 导航 案例 ,目标 视图 即 为 源 视 图 。 当 页 面 呈 现 后 ,如 果 用 户 单 击 
“GET 请 求 ” 按 钮 , 则 直接 导航 (GET 请 求 ) 至 已 经 确定 的 目标 页 面 。 


5.7 视图 参数 与 可 书签 化 URL 


前 面 介 绍 , 由 h:link 和 h:button 标记 引发 的 导航 是 一 种 直接 请 求 (GET 请 求 )。GET 
请 求 通常 用 于 查询 某 个 资源 (不 改变 服务 器 端 资源 的 状态 )、 并 通过 视图 显示 该 资源 的 状态 ， 
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所 以 被 认为 是 等 寡 和 安全 的 ,其 请 求 URL 可 以 作为 书签 加 以 收藏 。 但 在 Web 应 用 中 ,页 面 
视图 通常 是 动态 的 , 即 它 可 以 显示 某 类 资源 中 的 任何 一 个 资源 的 状态 。 所 以 在 查询 一 个 资 
源 时 ,不 仅 需 要 指定 相应 的 视图 ID, 通 常 还 需要 指定 与 资源 相关 的 一 些 查 询 参数 。 

本 节 介 绍 如 何在 视图 中 添加 用 于 接收 请 求 参数 的 组 件 一 一 视图 参数 ,如 何在 请 求 URL 
中 设置 查询 参数 ,以 及 如 何 利 用 查询 参数 完成 查询 操作 。 


5.7.1 视图 参数 


视图 参数 标记 f: viewParam 在 服务 器 端 表 示 为 UIViewParameter 组 件 。 该 组 件 不 会 
在 客户 端 呈 现 , 但 可 以 接收 从 客户 端 发 来 的 请 求 参 数 。 

可 以 在 JSF 页 顶部 中 添加 视图 参数 标记 f: viewParam。 视 图 参数 作为 当前 视图 的 一 种 
元 数据 ,视图 参数 标记 必须 舱 套 在 f: metadata 标记 内 。 下 面 是 f: viewParam 标记 的 用 法 
示例 。 


<f:metadata> 
<f:viewParam name="user" value="#{me.username}"/> 
</f:metadata> 


当 请 求 被 处 理 时 , 若 存在 名 为 user 的 查询 参数 ,me 受 管 bean 的 setUsername 方法 将 
被 调用 并 传人 相应 的 查询 参数 。 

一 个 JSF 页 面 可 以 有 任意 数目 的 视图 参数 ,或 者 说 ,在 f: metadata 标记 内 可 以 包含 多 
个 f:viewParam 标记 。 

由 于 UIViewParameter 类 扩展 UIInput 类 ,所 以 第 4 章 介绍 的 基本 输入 类 标记 的 一 些 
属性 在 视图 参数 标记 中 同样 是 适用 的 ,比如 可 以 为 视图 参数 设置 转换 器 、 验 证 器 等 。 与 回 送 
请 求 一 样 ,对 包含 视图 参数 的 视图 的 直接 请 求 ,JSF 框架 在 处 理 时 ,也 要 经 历 恢复 视图 .应 用 
请 求 值 处理 验 证 、 更 新 模型 值 .调用 应 用 和 呈现 响应 各 个 阶段 。 


5.7.2 设置 请 求 参数 


无 论 是 h:button 和 h:link 触发 的 GET 请求, 还 是 h:commandButton 和 h:commandLink 
引起 的 重 定 向 GET 请 求 ,如 果 目 标 视图 包含 视图 参数 ,那么 通常 应 该 设置 相应 的 请 求 参 
数 。 下 面 介绍 设置 请 求 参数 的 各 种 渠道 。 

1. 基于 视图 参数 设置 请 求 参 数 

在 导航 处 理 确定 目标 视图 后 ,可 以 基于 目标 视图 的 视图 参数 现 有 值 自动 设置 相应 的 请 
求 参 数 ( 请 求 参 数 名 与 视图 参数 名 相同 )。 这 样 当 导 航 至 目标 视图 时 ,这 些 请 求 参数 将 送 至 
目标 视图 并 重新 设置 其 中 的 视图 参数 。 

有 多 种 方法 导致 导航 处 理 器 利用 视图 参数 设置 请 求 参数 ,这 些 方法 有 各 自 的 适用 范围 。 

方法 1: 在 h:link 或 h:button 标记 中 ,将 includeViewParams 属性 设置 为 true。 下 面 
是 这 种 方法 的 示例 。 


<h:link outcome="index" includeVieweParams="true" value="OK"/> 

这 种 方法 不 仅 适用 于 隐 式 导航 ,也 适用 于 规则 导航 。 

方法 2: 在 h:commandButton 和 h:commandLink 引起 的 重 定向 GET 请 求 中 ,可 以 在 结果 
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值 中 添加 一 个 名 为 includeViewParams、 值 为 true 的 请 求 参数 。 下 面 是 这 种 方法 的 示例 。 


<h:commandButton action="index?faces-redirect=true&amp;includeViewParams=true" 
value=" 确 认 "/> 


这 种 方法 仅 适 用 于 隐 式 导航 ,当然 结果 值 既 可 以 在 action 属性 中 直接 指定 ,也 可 以 通过 
动作 方法 返回 。 

方法 3: 在 导航 规则 声明 中 ,将 redirect 元 素 的 include-view-params 属性 值 设置 为 
true。 下 面 是 这 种 方法 的 示例 。 


<navigation-case> 
<from-outcome>ok</from-outcome> 
<to-view-id>/index.xhtml</to-view-id> 
<redirect include-view-params=true/> 


</navigation-case> 


这 种 方法 适用 于 规则 导航 , 既 适 用 于 h:commandButon 和 h:coomandLink 标记 ,也 适 
用 于 h:button 和 h:link 标记 。 

2. 在 结果 值 中 指定 请 求 参数 

如 果 采 用 隐 式 导航 ,可 以 在 结果 值 中 指定 请 求 参数 。 

下 面 代码 演示 了 h:link 标记 (或 h:button 标记 ) 在 结果 值 中 指定 请 求 参数 的 方法 。 


<h:link outcome="index?user=liming" value="OK"/> 


结果 值 既 可 以 在 outcome 属性 中 直接 指定 ,也 可 以 通过 计算 某 EL 值 表达 式 获 得 。 如 
果 指 定 多 个 请 求 参 数 ,各 参数 之 间 用 “&" 分 隔 ( 在 JSF 页 面 中 ,应 使 用 其 特殊 表示 法 ， 
即 : &.amp;)。 

下 面 代码 演示 了 h:commandLink 标记 (或 h:commandButton 标记 ) 在 结果 值 中 指定 请 
求 参数 的 方法 。 

<h:commandButton action="index?faces-redirect=true&tamp;user=liming" value= 

"确认 "/> 

结果 值 既 可 以 在 action 属性 中 直接 指定 ,也 可 以 通过 动作 方法 返回 。 

3. 在 导航 规则 中 指定 请 求 参数 

如 果 采 用 规则 导航 ,可 以 在 导航 规则 声明 中 ,用 嵌 套 于 redirect 元 素 的 view-param 子 
元 素 指定 请 求 参数 。 


<redirect> 
<view-param> 
<name>user</name> 
<value>liming< /value> 
</view-param> 


</redirect> 


其 中 ,redirect 元 素 中 可 以 包含 多 个 view-param 子 元 素 . 每 个 view-param 元 素 指定 一 个 请 
求 参 数 。 
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这 种 设置 请 求 参 数 的 渠道 既 适 用 于 h:commandButon 和 h:coomandLink 标记 ,也 适用 
于 h:button 和 h:link 标记 。 

4. 利用 f:param 子 标记 设置 请 求 参数 

可 以 在 h:link 或 bh:button 标记 内 艇 入 f:param 子 标记 ,以 便 为 GET 请 求 设置 请 求 参数 。 


<h:link outcome="index" value="OK"> 
<f:param name="user" value="liming"/> 


</h:link> 
上 面 标记 呈现 后 产生 的 结果 类 似 于 如 下 : 
<a href="/jsfapp/faces/index.xhtml?user=liming">OK</a> 


说 明 : 也 可 以 在 h:commandButon 和 h:coomandLink 标记 内 柚 入 f:param 子 标记 ,但 
由 此 指定 的 请 求 参 数 只 是 作为 回 送 请 求 (POST 请 求 ) 的 请 求 参 数 , 而 不 会 作为 之 后 引发 的 
重 定向 请 求 的 请 求 参数 。 

上 面 介绍 了 四 种 为 GET 请 求 设置 请 求 参数 的 渠道 。 可 以 同时 采用 多 种 渠道 设置 请 求 
参数 ,但 上 述 第 2 种 和 第 3 种 渠道 不 会 同时 出 现 。 另 外 ,这 些 渠道 有 一 定 的 优先 级 ,由 低 到 
高 依次 为 : 

。 基于 视图 参数 设置 请 求 参 数 。 

。 在 结果 值 中 指定 请 求 参 数 或 在 导航 规则 中 指定 请 求 参数 。 

。 利用 f:param 子 标记 设置 请 求 参 数 。 

若 不 同 的 渠道 设置 了 同名 的 请 求 参数 , 则 按 上 述 顺序 ,后 面 的 代替 前 面 的 。 


5.7.3 preRenderView 系统 事件 


正如 前 面 所 述 , 当 通过 GET 方式 请 求 一 个 页 面 视图 时 ,其 中 的 请 求 参 数 将 被 用 于 设置 
目标 视图 的 视图 参数 。 但 与 h:commandButton 和 h:commandLink 标记 引起 的 POST 请 
求 能 够 触发 动作 事件 不 同 ,由 h:button 和 h:link 标记 引起 的 GET 请 求 并 不 会 触发 动作 事 
件 ,因此 也 无 法 指定 动作 方法 、 进 而 在 “调用 应 用 ”阶段 执行 该 方法 。 那 么 如 何 能 够 在 合适 的 
时 机 利用 视图 参数 来 检索 和 定位 视图 实际 要 呈现 的 资源 呢 ? 

preRenderView 是 一 种 组 件 系 统 事 件 (ComponentSystemEvent)。 这 种 事件 在 呈现 响 
应 阶段 .在 视图 实际 呈现 前 触发 ,事件 源 是 当前 要 呈现 的 视图 的 根 ( UIViewRoot)。 一 般 情 
况 下 ,可 以 在 视图 根 上 为 该 种 事件 注册 一 个 监听 方法 .然后 在 监听 方法 中 实现 对 要 呈现 的 资 
源 的 检索 和 定位 。 

JSF 核心 标记 f:event 能 够 在 某 组 件 上 为 某 种 感 兴趣 的 组 件 系 统 事件 注册 一 个 监听 方 
法 。 下 面 代码 在 视图 根 上 注册 了 一 个 监听 方法 ,用 于 监听 preRenderView 事件 。 


<f:metadata> 
<f:event type="preRenderView" listener="#{me.method}"/> 
</f:metadata> 
要 在 视图 根 上 注册 监听 方法 ,一 般 应 将 f:event 标记 嵌 套 于 f:metadata 标记 内 。type 属性 
指定 感 兴趣 的 事件 类 型 ,可 以 采用 事件 类 型 的 短 名 字 (shortrName) ,如 preRenderView, 也 可 以 
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使 用 事件 类 型 的 完整 类 名 ,如 javax. faces. event PreRenderViewEvent。listener 属性 指定 一 个 
EL 方法 表达 式 ,作为 事件 的 监听 方法 。 组 件 系 统 事 件 的 监听 方法 的 方法 头 一 般 如 下 : 


public void method (ComponentSystenEvent cse) 


如 果 监 听 方 法 不 需要 了 解 事件 的 有 关 信 息 , 也 可 以 不 包含 形 参 。 在 方法 体 中 ,如 果 处 理事 
件 时 出 现 异常 情况 ,不想 再 继续 处 理 该 事件 ,可 以 抛 出 一 个 AbortProcessingException 型 例外 。 


5.8 论坛 一 发 表 主 题 与 回复 


本 节 继 续 4. 11 节 介 绍 的 应 用 项 目 (luntan_logandreg) ,对 其 进行 功能 扩充 并 做 必要 的 
修改 。 为 保持 原先 项 目的 独立 性 ,这 里 新 创建 一 个 名 为 luntan_input 的 JSF 应 用 项 目 , 并 从 
原先 项 目 复 制 所 有 的 JSF 页 面 \ 源 包 中 的 所 有 Java 包 和 Java 类 。 

与 原先 的 应 用 项 目 luntan_logandreg 相 比 ,新 的 应 用 项 目 luntan_input 主要 增加 了 以 
下 功能 : 统计 和 显示 主题 数 、 新 建 主 题 \, 统 计 和 显示 某 一 主题 的 回复 数 、 对 某 个 主题 进行 回 
复 等 。 

图 5-2 显示 了 该 应 用 的 运行 效果 。 只 有 登录 的 用 户 才能 新 建 主题 或 对 主题 进行 回复 。 
图 5-2(a) 是 主页 ,是 用 户 登 录 后 的 显示 效果 。 单 击 主页 中 的 “新 建 主 题 "按钮 将 进入 “新 建 主 


=|B Mtp://1ocdhost:8080/luntan_input/faces/inputTop 
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题 "页 面 , 如 图 5-2(b) 所 示 。 在 “新 建 主题 页面, 输入 主题 的 标题 和 内 容 后 单 击 “ 提 交 ” 按 钮 会 
返回 主页 。 图 5-2(c) 是 “查看 回复 ”页面 : 单 击 其 中 的 "回复 主题 "按钮 将 进入 "回复 主题 页面 ,如 
图 52(d) 所 示 。 在 “回复 主题 "页 面 .输入 回复 内 容 后 单 击 “ 回 复 ” 按 钮 会 返回 “查看 回复 ”页 面 。 

在 该 应 用 中 ,“ 查 看 回复 ”页 面 与 主页 之 间 没 有 建立 导航 路 径 。 要 显示 “查看 回复 ”页 面 ， 
需要 在 浏览 器 地 址 栏 输入 其 地 址 ,并 提供 一 个 名 称 为 tid 的 请 求 参数 ,用 以 指定 主题 编 
号 ,如 : 


http://localhost:8080/luntan input/faces/showReply.xhtml?tid=1 


5.8.1 扩充 模型 


在 该 应 用 中 ,需要 添加 主题 和 回复 等 论坛 应 用 的 核心 业务 数据 ,并 提供 相应 的 业务 处 理 
方法 。 

首先 在 entity 包 中 定义 分 别 表示 主题 帖 和 回复 帖 的 Topic 类 和 Reply 类 。 

Topic 类 定义 了 idvtitle .content 等 9 个 实例 变量 ,除了 若干 构造 方法 ,每 个 实例 变量 都 
有 相应 的 getter 和 setter 方法 。Reply 类 还 实现 了 Comparable 接口 ,其 中 的 compareTo 方 
法 可 以 按 最 后 回复 时 间 (lastreplytime) 比 较 两 个 主题 的 大 小 ,最 后 回复 时 间 越 大 ,相应 的 主 
题 帖 越 小 。 

代码 清单 5-6 给 出 了 该 类 的 定义 ,其 中 各 实例 变量 相应 的 getter 和 setter 方法 被 省 
略 了 。 

代码 清单 5-6 Topic. java 


1. package entity; 


2. import java.util .Date; 


3。 
4. public class Topic implements Comparable<Topic>{ 
5 private Integer id; // 主 题 帖 编 号 
6. private String title; // 标 题 
7. private String content; // 内 容 
8 private Date createtime; // 创 建 时 间 
9 private int clickcount; // 点 击 数 
10. private int replycount; // 回 复数 
11. private Date lastreplytime; // 最 后 回复 时 间 
12. private Client client; // 创 建 人 
13. private Client clientl; // 最 后 回复 人 
14. 
15. Public Topic(){ 
16. } 
17. Ppublic Topic (Integer id){ 
18 . this.id=id; 
19, 过 
20。 public Topic(Integer id,String title,String content,Date createtime, 
21。 int clickcount, int replycount,Date lastreplytime){ 
22, this.id=id; 


23。 this.title=title; 


24. this.content=content; 

25。 this.createtime=createtime; 

26 . this.clickcount=clickcount; 

立 7 this.replycount=replycount; 

28s this.lastreplytime=lastreplytime; 

29, 1 

30. 

31. // 各 实例 变量 对 应 的 getter 方法 和 setter 方法 
32, 


33. override 

34. public int compareTo (Topic 七 ) { 

本 和 return - (lastreplytime.compareTo(t.lastreplytime)); 
36. } 

37» } 


Reply 类 定义 了 id、content、replytime 等 5 个 实例 变量 ,除了 若干 构造 方法 ,每 个 实例 
变量 都 有 相应 的 getter 方法 和 setter 方法 。Reply 类 还 实现 了 Comparable 接口 ,其 中 的 
compareTo 方法 可 以 按 回 复 时 间 (replytime) 比较 两 个 回复 的 大 小 ,回复 时 间 越 大 ,相应 的 
回复 帖 也 越 大 。 

代码 清单 5-7 给 出 了 该 类 的 定义 ,其 中 各 实例 变量 相应 的 getter 和 setter 方法 被 省 
略 了 。 

代码 清单 5-7 Reply.java 


1. package entity; 
2. import java.util.Date; 
3 
4. public class Reply implements Comparable<Reply>{ 
5. Pprivate Integer id; // 回 复 帖 编号 
6 private String content; // 内 容 
7 private Date replytime; // 回 复 时 间 
8 private Topic topic; // 相 应 的 主题 
9. private Client client; // 回 复 人 
29 
LL public Reply(){ 
12, } 
和 public Reply(Integer id){ 
as this.id=id; 
15, 中 
16. public Reply(Integer id,String content,Date replytime){ 
17。 this.id=id; 
18, this.content=content; 
19, this.replytime=replytime; 
20. bs 
4 


和 是 记 


22. // 各 实例 变量 对 应 的 getter 方 法 和 setter 方 法 
23。 

24. override 

25. public int compareTo (Reply r){ 

26s return replytime.compareTo(r.replytime); 
和 了 } 

28. 

人 29 } 


然后 在 model 包 的 DataBase. java 类 中 定义 现 有 的 主题 帖 和 回复 帖 数据 。 主 题 帖 保存 
在 一 个 List< Topic> 型 的 表 中 ,回复 帖 保存 在 一 个 List 和 Reply 之 型 的 表 中 。 当 类 装 人 初 
始 化 时 ,自动 创建 10 个 主题 帖 , 但 没有 创建 任何 回复 帖 。 

代码 清单 5-8 列 出 了 该 类 的 代码 ,其 中 原 有 的 涉及 用 户 数 据 的 代码 被 忽略 了 。 

代码 清单 5-8 ”DataBase. java( 部 分 ) 


public class DataBase { 


private static final List<Topic>topics=new ArrayList<Topic>(); 


1 

2 

3 

4. private static final List<Reply>replys=new ArrayList<Reply>(); 
5 

6 

7 

8 


String s=" uuuuuuuuuu "; 


9. Date date; 
10. Topic t=null; 
11, for (int i=1;i<11;i++){ 
FE date=new Date(); 
13, t=new Topic(i,"title"+s+i,"content"+s+i,date,0,0,date); 
14. t.setCclient (cl1); 
FE t.setclientl(c1); 
16. topics.add (t); 
EY } 
18, 上 
9% :eeesee 
20 . public static List<Topic> getTopics (){ 
有 return topics; 
党 入。 染 
23. public static List<Reply> getReplys ()1{ 
24. return replys; 
5 
25 


最 后 提供 相关 的 业务 处 理 代 码 。 这 里 新 建 TopicManager 和 ReplyManager 两 个 Java 
类 ,两 个 类 都 属于 model 包 。 
TopicManager 类 (代码 清单 5-9) 定 义 了 涉及 主题 的 业务 方法 ,包括 往 主 题 表 添 加 一 个 
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主题 ,为 某 主题 添加 一 个 回复 等 。getTopics 方法 返回 所 有 主题 , 且 各 主题 按 最 后 回复 时 间 
降序 排序 。 
代码 清单 5-9 TopicManager.java 


. Package model; 

. import entity.Reply; 

. import entity.Topic; 

. import java.util.ArrayList; 


1 
2 
3 
4 
5. import java.util.Collections; 
6. import java.util.List; 

7 

8 


. Public class TopicManager { 


9. public int insertTopic (Topic topic){ // 添 加 一 个 主题 
10. List<Topic>topics=DataBase.getTopics () 7 
11, int id=0; 
gs synchronized(topics){ 
时 id=topics.size()+1; 
14. topic.setId(id); 
L5s topics.add (topic); 
16. } 
17. return id; 
18. } 
19. public Topic getTopicById(int id)1{ // 根 据 id 返回 相应 的 主题 
20.， List<Topic>topics=DataBase.getTopics (); 
Ss Topic t=null; 
2 for (Topic tl:topics){ 
之 35 if(tl.getId()==id){ 
24. t=t1; 
25s break; 
26. } 
了 7 rr 
28 . Feturn 七 7 
29， } 
30. public List<Topic>getTopics(){ // 返 回 所 有 的 主题 
CF ArrayList<Topic> topics=new ArrayList<Topic>(DataBase.getTopics()); 
32 。 Collections .sort (topics); 
33, return topics; 
34. } 
35. public void replyTopic (Topic topic,Reply reply) { // 为 主题 添加 一 个 回复 
36 . topic.setReplycount (topic.getReplycount ()+1) 7 
37 。 topic.setClientl(reply.getClient ()); 
38 topic.setLastreplytime (reply.getReplytime()); 
39. 】} 
40. } 


ReplyManager 类 (代码 清单 5-10) 定 义 了 涉及 回复 的 业务 方法 ,包括 往 回复 表 添 加 一 个 
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回复 .返回 指定 主题 的 所 有 回复 等 。getReplys(int) 方 法 返回 指定 主题 的 所 有 回复 ,上 且 各 回 
复 按 回复 时 间 升 序 排序 。 
代码 清单 5-10 ”ReplyManager. java 


. package model; 
. import entity.Reply; 
. import java.util.ArrayList; 


. import java.util.Collections; 


. Public class ReplyManager { 
public int insertReply (Reply reply){ // 添 加 一 个 回复 


1 
2 
3 
4 
5. import java.util.List; 
6 
法 
8 
9 List<Reply>replys=DataBase.getReplys () 7 


10. int id=0; 

Ys synchronized(replys){ 

Ts id=replys.size()+1; 

V3 reply.setIdl(id); 

14. replys.add (reply); 

5s } 

36。 return id; 

17。 } 

18. Ppublic List<Reply>getReplys (int id){ // 根 据 主题 id 返回 该 主题 所 有 的 回复 
19 . List<Reply> replys=DataBase.getReplys(); 
20。 List<Reply> list=new ArrayList<Reply> (); 
2 for (Reply r:replys)t{ 

if(r.getTopic () .getId()==id) list.add(r); 
23w } 

24. Collections .Sort (list); 

25, return list; 

26。 

2 


5. 8.2 创建 “新 建 主题 "页 


“新 建 主 题 ” 页 显示 一 个 表单 ,用 户 可 以 输入 新 主题 的 标题 和 内 容 。 当 用 户 单 击 “ 提 交 ” 
按钮 时 ,应 用 系统 将 创建 一 个 主题 并 添加 到 主题 表 中 .然后 重 定向 至 主页 。 

作为 支撑 该 页 面 的 受 管 bean,InputTopic 类 定义 了 与 主题 的 标题 和 内 容 相 对 应 的 可 读 
写 的 title 和 content 属性 。 另 外 为 主题 的 内 容 提 供 了 一 个 验证 方法 ,确保 内 容 长 度 不 会 超 
出 1000 个 字符 。 代 码 清 单 5-11 是 该 bean 类 的 代码 ,其 中 各 属性 的 getter 方法 和 setter 方 
法 被 忽略 了 。 

代码 清单 5-11 InputTopic. java 


1. package bean; 
2. import entity.Client; 
3. import entity.Topic; 


=» Il 证 


. import java. 


. import util. 


util.Date; 


. import javax.faces .application.FacesMessage; 

. import javax.faces .bean.ManagedBean; 

. import javax.faces .bean.RequestScoped; 

. import javax.faces .component .UIComponent; 

. import javax.faces.context.FacesContext; 

. import javax.faces .validator.ValidatorException; 


. import model .TopicManager; 


ELUtil; 


. @ManagedBean 
. RequestScoped 
. Public class InputTopic { 


private String title; 


private String content; 


Public void validate (FacesContext context,UIComponent comp,Object val) 


// 主 题 内 容 验 证 方法 


// 各 属性 对 应 的 gettez 方 法 和 setter 方法 


throws ValidatorExceptiont{ 


String str=(String)val; 
if(str.length()>1000){ 


throw new ValidatorException (new FacesMessage (FacesMessage .SEVERITY INFO, 


} 


null,null)); 


public String create(){ 


Client client=sessinfo.getClient(); 
if(client!=null){ 


Topic topic=new Topic(); 


Date date=new Date (); 


topic. 
topic. 
topic. 
topic. 
topic. 
topic. 
topic. 


topic. 


setTitle(title); 
setContent (content); 
setClient (client); 
setCreatetime (date); 
SetClickcount (0); 
setReplycount (0); 
setClientl (client); 
setLastreplytime (date); 


TopicManager tm=new TopicManager (); 


tm.insertTopic(topic); 


} 


return "index?faces-redirect=true"; 


// 主 题 标 题 
// 主 题 内 容 


/A 提交” 主题 动作 方法 


SessionInfo sessinfo= (SessionInfo)ELUtil.getBean ("sessinfo"); 


代码 清单 5-12 列 出 了 * 新 建 主题 ”页面 (inputTopic. xhtml) 的 内 容 。 当 用 户 单 击 “ 提 交 ” 
按钮 时 会 调用 受 管 bean 的 create 方 法 ,完成 添加 新 主题 的 功能 。 
代码 清单 5-12 inputTopic. xhtml 


30.3 


,<?xml version='1.0' encoding= 'UTE-8' ?> 


.<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 


"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 


.<html xmlns="http://www.w3.0rg/1999/xhtml" 


xmlns:h="http://java.sun.com/jsf/html"> 
<h:head> 
<title> 轻 松 论坛 新 建 主题 </title> 
</h:head> 
<h:body> 
<h:form id="f1"> 
<p> 
<h:outputText value= "新建 主题 : "/> 
</p> 
<p> 
<h:outputLabel for="inputl" value= "标题 : "/> 
<h:inputText id="input1l" value="#{inputTopic.title}" 
maxlength="50" size="50" 
required="true" requiredMessage=" 标 题 不 能 为 空 "/> 
<h:message for="inputl" styleClass="font4"/> 
</p> 
<p> 
<h:outputLabel for="input2" value= "内容 : "/> 
<h:message for="input2" styleClass="font4"/> 
<br/> 
<h:inputTextarea id="input2" value="#{inputTopic.content}" 
rows="5" cols="50" 
required="true" requiredMessage=" 内 容 不 能 为 空 " 
validator="#{inputTopic.validate}" 
validatorMessage= "长度 不 能 超过 1000 字符 "/> 
</p> 
<p> 
<h:commandButton value=" 提 交 " action="# {inputTopic.create}"/> 
</p> 
</h:form> 


</h:body> 


-</html> 


修改 主页 


主页 (index. xhtml) 原 先 的 主要 功能 是 显示 注册 人 数 和 在 线 人 数 。 现 在 需要 增加 一 些 
功能 ,包括 显示 现 有 的 主题 数 ,以 及 提供 一 个 “新 建 主题 "按钮 , 单 击 该 按钮 可 以 导航 至 "新 建 
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主题 ”页面 。 

为 此 ,需要 对 主页 及 相关 的 受 管 bean 作出 相应 的 修改 。 受 管 bean(Index. java) 需 要 添 
加 一 个 类 型 为 List 二 Topic 二 的 可 读 的 topic 属性 ,代码 清单 5-13 给 出 了 相关 的 代码 (该 
bean 类 原先 的 代码 被 忽略 了 )。 

代码 清单 5-13 ”Index. java( 部 分 ) 


public class Index { 
private List<Topic> topics; // 主 题 表 
public Index(){ 


TopicManager tm=new TopicManager (); 


} 
public List<Topic> getTopics (){ 


Ls 

色 

3 

4 

5 topics=tm.getTopics (); 
6 

7 

8 return topics; 

9 


10. 。…… 
11。} 


对 主页 (index. xhtml) 的 修改 主要 是 在 原 有 内 容 的 后 面 添加 了 一 个 表单 , 见 代码 清 
单 5-14, 其 中 该 页 面 原先 的 内 容 被 忽略 了 。 
代码 清单 5-14 index. xhtml( 部 分 ) 


1. <h:body> 
2。 se 


3 

<p> 

5 <h:outputText value= "主题 数 :#{index.topics.size()}"/> 

6. </p> 

2 <p> 

8 <h:commandButton value=" 新 建 主题 " action="inputTopic?faces-redirect=true" 
9 disabled="#{sessinfo.client==null1}"/> 

ak </p> 

11. </h:form> 
12. </h:body> 


当 单 击 “ 新 建 主 题 " 按 钮 时 ,将 采用 隐 式 导航 直接 重 定向 至 “新 建 主 题 " 页 面 。 如 果 用 户 
还 没有 登录 ,该 按钮 是 不 可 用 的 。 


5. 8.4 ”创建 “回复 主题 ”页面 


访问 “回复 主题 "页面 时 需要 提供 一 个 名 为 tid 的 请 求 参数 。 该 请 求 参数 将 作为 视图 参 
数 , 用 以 指定 某 个 主题 编号 .“ 回 复 主 题 "页 面 允 许 对 指定 的 主题 进行 回复 。 
作为 支撑 该 页 面 的 受 管 bean,InputReply 类 定义 了 与 回复 主题 相关 的 属性 ,包括 tid、 
topic 和 content。 其 中 ,tid 与 视图 参数 绑 定 在 一 起 ,topic 是 根据 tid 获得 的 主题 (页 面 上 要 
显示 主题 的 标题 ),content 接收 回复 的 内 容 。 另 外 ,验证 方法 validate 用 于 确保 回复 内 容 的 
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长 度 不 会 超过 1000 个 字符 ,动作 方法 reply 创建 一 个 回复 ,然后 将 回复 添加 至 回复 表 并 修 


改 相关 主题 的 属性 。 代 码 清单 5-15 是 该 bean 类 的 代码 。 
代码 清单 5-15 InputReply.java 


// 根 据 主题 id 获得 的 当前 主题 


1. package bean; 
2. import entity.Client; 
3. import entity.Reply; 
4. import entity.Topic; 
5. import java.io.Serializable; 
6. import java.util.Date; 
7. import javax.faces .application.FacesMessage; 
8. import javax.faces .bean.ManagedBean; 
9. import javax.faces .bean.ViewScoped; 
10. import javax.faces .component .UIComponent; 
11. import javax.faces .context.FacesContext; 
12. import javax.faces .validator.ValidatorException; 
13. import model .ReplyManager; 
14. import model .TopicManager; 
15. import util.ELUtil; 
16. 
17. @ManagedBean 
18. @ViewScoped 
19. public class InputReply implements Serializable { 
20. private int tid; // 主 题 id 
ds public int getTid(){ 
22。 return tid; 
23。 } 
24. public void setTid(int tid){ 
25。 this.tid=tid; 
26% TopicManager tm=new TopicManager (); 
二 topic=tm.getTopicById (tid); 
28; b 
29. private Topic topic; 
30 public Topic getTopic(){ 
本 return topic; 
3 } 
33. private String content; // 回 复 内 容 
3 public String getContent (){ 
35s return content; 
36。 . 
37. public void setContent (String content){ 
38 . this.content=content; 
39. 上】 
40. public void validate (FacesContext context,UIComponent comp,Object val) 
41. throws ValidatorException{ 


// 回 复 内 容 验证 方法 


42. String str= (String)val; 


43. if(str.length()>1000){ 

44. throw new ValidatorException (new FacesMessage (FacesMessage .SEVERITY INFO, 
45. null,null)); 

46. } 

47. 长 

48. public String reply(){ /六 回复 ?动作 方法 
49。 SessionInfo sessinfo= (SessionInfo)ELUtil.getBean ("sessinfo"); 
50， Client client=sessinfo.getClient (); 

Sy if(client!=null){ 

52。 Reply reply=new Reply(); 

S53s reply.setContent (content); 

54. reply.setClient (client); 

55, reply.setTopic(topic); 

56» reply.setReplytime (new Date ()); 

57。 

58 . ReplyManager rm=new ReplyManager () 7 

5 rm.insertReply (reply); 

60. 

‘Gs TopicManager tm=new TopicManager (); 

62. tm.replyTopic (topic, reply); 

63. } 

64. return "showReply?faces-redirect=true&amp;tid="+tid; 
65. } 

66. } 


“回复 主题 "页面 inputReply. xhtml 见 代码 清单 5-16。 当 用 户 单 击 “ 回 复 ” 按 钮 时 会 调 
用 受 管 bean 中 的 reply 方法 。 方 法 在 完成 相应 的 保存 任务 后 ,将 采用 隐 式 导航 导航 至 “ 查 
看 回复 ”页 面 。 

代码 清单 5-16 inputReply. xhtml 


1. <?xml version='1.0' encoding= 'UTF-8' ?> 

.<!DOCTYPE html PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional .dtd"> 
.<html xmlns="http://www.w3.0rg/1999/xhtml" 
xmlns:h="http://java.sun.com/jsf/html" 
xmlns:f="http://java.sun.com/jsf/core"> 


<f:metadata> 


o auwmwwN 


<f:viewParam name= "tid" value="#{inputReply.tid}"/> 
9. </f:metadata> 

10. <h:head> 

Ls <title> 轻 松 论坛 回复 主题 </title> 

12. </h:head> 

43. <hsbody> 

14. <h:form id="f1"> 

15. <p> 


“ LL 


16 . <h:outputText value= "回复 主 题 : "/> 


17. </p> 

18. <p> 

19. <h:outputText value= "标题 : "/> 

205 <h:outputText value= "# {inputReply.topic.title}"/> 
Ss </p> 

22. <P> 

235 <h:outputLabel for="input2" value=" 内 和 

24. <h:message for="input2"/> 

25。 <br/> 

26. <h:inputTextarea id="input2" value="#{inputReply.content}" 
2 rows="5" cols="50" 

20, required="true" requiredMessage=" 内 容 不 能 为 空 " 
29. validator="#{inputTopic.validate}" 

30 . validatorMessage= "长 度 不 能 超过 1000 字符 "/> 

31; </p> 

3232， <P> 

33 . <h:commandButton value=" 回 复 "action="#{inputReply.reply}"/> 
34. </p> 

35s </h:form> 

36. </h:body> 

37. </html> 


需要 特别 注意 的 是 ,这 里 的 InputReply 受 管 bean 是 视图 作用 域 的 。 下 面 分析 一 下 若 
把 其 设置 成 请 求 作用 域 会 产生 什么 问题 。 当 用 户 请 求 "回复 主题 "页面 时 ,必须 提供 tid 请 
求 参 数 。 该 请 求 参数 被 作为 视图 参数 .并 用 于 设置 受 管 bean 的 tid 属性 。 在 设置 tid 属性 
时 ,会 获取 topic 属性 值 。 若 受 管 bean 是 请 求 作 用 域 , 则 视图 呈现 后 ,该 受 管 bean 将 消失 ， 
原 有 的 tid 和 topic 将 不 再 存在 。 这 样 , 当 用 户 单 击 “ 回 复 ” 按 钮 后 ,那么 在 服务 器 端 就 只 有 
回复 的 内 容 , 而 没有 相关 主题 的 数据 ,所 以 接 下 来 的 业务 处 理 将 无 法 进行 。 

当然 ,也 可 以 通过 改写 "回复 ”按钮 的 标记 ,比如 用 和 嵌 套 的 f:param 标记 将 当前 视图 参数 
设置 为 请 求 参数 ,使 得 单 击 “ 回 复 ” 按 钮 产生 的 请 求 仍 然 包 含 原先 的 tid 请 求 参数 。 就 像 原 
先 的 GET 请 求 该 页 面 一 样 ,这 次 的 POST 请 求 该 页 面 同 样 会 用 请 求 参数 去 设置 受 管 bean 
的 tid 和 topic 属性 。 但 这 一 设置 过 程 发 生 于 JSF 请 求 处 理 生 命 周期 的 “更 新 模型 值 ”阶段 。 
如 果 在 “处 理 验 证 ”阶段 ,发 现 回 复 内 容 不 合法 (如 空 或 长 度 大 于 1000 个 字符 ) ,那么 将 会 跳 
过 其 他 阶段 .直接 进入 “呈现 响应 ”阶段 。 这 样 ,原来 的 tid 将 不 复 存 在 。 

将 InputReply 受 管 bean 设置 为 视图 作用 域 可 以 避免 以 上 问题 的 出 现 。 


5.8.5 创建 “查看 回复 "页面 


“查看 回复 ”页 面 显 示 某 一 主题 的 标题 、 回 复数 ,并 提供 一 个 “回复 主题 "按钮 , 单 击 该 按 
钮 可 携带 一 个 请 求 参 数 tid( 当 前 主题 的 编号 ) 导 航 至 “回复 主题 ”页 面 。 
作为 支撑 该 页 面 的 受 管 bean, ShowReply 类 定义 了 与 主题 及 其 回复 相关 的 属性 ,包括 
tid topic 和 replys。 其 中 ,主题 编号 tid 与 视图 参数 绑 定 在 一 起 ,topic 是 根据 tid 获得 的 主 
题 ( 页 面 上 要 显示 主题 的 标题 ) ,replys 是 一 个 包含 当前 主题 所 有 回复 的 表 。 代 码 清单 5-17 
20 


是 该 bean 类 的 代码 。 
代码 清单 5-17 ShowReply. java 


. Package bean; 

. import entity.Reply; 

. import entity.Topic; 

. import java.util.List; 

. import javax.faces .bean.ManagedBean; 

. import javax.faces .bean.RequestSscoped; 
. import model .ReplyManager; 


. import model .TopicManager; 


. @ManagedBean 
. QRequestScoped 
. Public class ShowReply { 


private int tid; // 主 题 id 
public int getTid(){ 
return tid; 
} 
public void setTid(int tiqd)t{ 
this.tid=tid; 
} 
public void initView(){ 
TopicManager tm=new TopicManager (); 
topic=tm.getTopicById (tid); 
ReplyManager rm=new ReplyManager (); 
replys=rm.getReplys (tid); 
Reply reply=new Reply (); 
reply.setContent (topic.getContent ()); 
reply.setClient (topic.getClient ()); 
reply.setId(0); 
reply.setReplytime (topic.getCreatetime ()); 
reply.setTopic(topic); 
replys.add(0, reply); 
} 
private Topic topic; // 当 前 主题 
public Topic getTopic()1{ 
return topic; 
} 
private List<Reply> replys; // 回 复 表 
public List<Reply> getReplys(){ 
return replys; 
} 
public String goReply (){ //* 回 复 主题 ”动作 方法 


return "inputReply?faces-redirect=trueg&amp;tid="+tid; 
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“查看 回复 "页面 showReply. xhtml 见 代码 清单 5-18。 页 面 在 开始 处 设置 了 一 个 视图 
参数 tid, 并 指定 了 一 个 preRenderView 事件 的 监听 方法 . 即 受 管 bean 的 initView 方法 。 当 
用 户 请 求 该 页 面 时 必须 提供 一 个 表示 某 主题 编号 的 tid 请 求 参数 ,该 请 求 参 数 将 设置 视图 
参数 tid, 进 而 设置 受 管 bean 的 tid 属性 。 在 页 面 呈现 前 将 引发 preRenderView 事件 , 受 管 
bean 的 initView 方法 被 调用 。initView 方法 首先 根据 tid 获取 主题 topic, 以 及 该 主题 的 所 
有 回复 的 表 replys, 然 后 基于 当前 主题 创建 一 个 回复 插入 到 表 replys 的 最 前 端 。 其 中 ,方法 
的 后 面 一 部 分 处 理 对 于 本 应 用 并 不 需要 ,主要 是 为 后 续 的 扩充 做 准备 的 。 

代码 清单 5-18 showReply. xhtml 


1. <?xml version='1.0' encoding= 'UTF-8' ?> 
2. <!DOCTYPE html PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 
3. "http://www.w3.0rg/TR/xhtml1l/DTD/xhtmll-transitional.dtd"> 
4. <html xmlns="http://www.w3.0rg/1999/xhtml" 
5 xmlns:h="http://java.sun.com/jsf/html" 
6 xmlns:f="http://java.sun.com/jsf/core"> 
7. <f:metadata> 
8 <f:viewParam name= "tid" value="#{showReply.tid}"/> 
9 <f:event type="preRenderView" listener="#{showReply.initView}"/> 
10. </f:metadata> 
11. <h:head> 
这 ; <title> 轻 松 论坛 -- 查 看 回复 < /title> 
13. </h:head> 
EF <h:body> 


15。 <h:form> 

16. <p> 

bb <h:outputText value=" 回 复数 :# {showReply.replys.size()-1}"/> 
18. </p> 

19, <p> 

0 <h:commandButton value=" 回 复 主题 " action="#{showReply.goReply}" 
ls disabled="#{sessinfo.client==nu11}"/> 
2 </p> 

23;, </h:form> 

24. <h:outputText value=" 主 题 :# {showReply.topic.title}"/> 


25. </h:body> 
26. </html> 


至 此 ,该 应 用 的 所 有 内 容 都 已 经 介绍 。 可 以 看 出 ,相关 的 业务 数据 已 比较 充分 和 完善 ， 
但 页 i eg 比如 ,主题 表 已 被 获取 并 存放 在 受 管 bean 中 ,但 主页 中 只 
显示 出 主题 数 ,并 没有 显示 各 主题 的 数据 ; 某 个 主题 的 回复 表 已 经 生成 ,但 “查看 回复 "页面 
仅 显 示 出 回复 数 , 并 没有 显示 各 回复 的 信息 。 在 第 6 章 介 绍 完 数据 表格 组 件 后 ,论坛 应 用 将 
主要 关注 这 方面 的 扩充 。 
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口 。 


5.9 小 2 


导航 处 理 是 指 根据 当前 请 求 的 上 下 文 状态 信息 确定 目标 页 面 (视图 ) 的 过 程 。 涉 及 
导航 处 理 的 组 件 包 括 以 下 几 个 。 

h:commandButton( 动 作 按钮 ) 。 

h:commandLink( 动 作 超 链接 ) 。 

h:button( 结 果 按 钮 ) 。 

h:link( 结 果 超 链接 )。 

导航 处 理由 导航 处 理 器 完成 。 导 航 处 理 器 在 进行 导航 处 理 时 ,首先 寻找 导航 规则 ， 
如 果 存 在 导航 规则 , 则 按 导航 规则 进行 导航 ;和 否则 按 默认 约定 进行 导航 。 前 者 称 为 
规则 导航 ,后 者 称 为 隐 式 导航 。 

重 定向 是 指 不 直接 把 目标 视图 呈现 给 客户 端 ,而 是 先 发 送 一 个 重 定向 响应 ,客户 端 
接收 到 重 定向 响应 后 ,再 自动 向 目标 视图 发 出 请 求 。 

动作 类 标记 产生 POST 请 求 ,采用 后 置式 导航 ;结果 类 标记 产生 GET 请 求 , 采 用 前 
置式 导航 。 

动作 类 标记 产生 POST 请 求 时 ,会 收集 表单 数据 作为 请 求 参 数 ;结果 类 标记 产生 
GET 请 求 时 ,可 以 通过 多 种 渠道 设置 请 求 参 数 。 

视图 参数 标记 f:viewParam 在 服务 器 端 表示 为 UIViewParameter 组 件 。 该 组 件 不 
会 在 客户 端 呈 现 , 但 可 以 接收 从 客户 端 发 来 的 请 求 参 数 。 


习 题 5 


术语 解释 。 
动作 值 ; 
结果 值 ; 
视图 ID。 


2. 简 述 重 定向 导航 的 过 程 ,什么 时 候 需 要 重 定向 ? 重 定向 有 什么 好 处 ? 
3. 
4 


试 分 别 比较 隐 式 导航 与 规则 导航 、 后 置式 导航 与 前 置式 导航 各 自 的 特点 。 


.如 何 为 h:button 和 h:link 触发 的 GET 请 求 设置 请 求 参 数 ? 


修改 应 用 项 目 sh4_logandreg( 第 4 章 习 题 5) 中 各 页 面 的 导航 方式 ,具体 要 求 如 下 : 


(1) 对 主页 index. xhtml 的 “登录 ”和 “注册 ” 超 链 接 , 采 用 h: link 标记 .GET 请 求 登录 
页 面 login. xhtml 和 注册 页 面 registry. xhtml。 

(2) 对 主页 index. xhtml 的 “退出 ” 超 链 接 , 采 用 h:commandLink 标记 产生 POST 请 
求 ,处 理 完 相应 的 业务 功能 后 ,再 重 定向 至 主页 本 身 。 

(3) 对 登录 页 面 login. xhtml 的 “注册 ”和 “返回 首页 ” 超 链接 ,采用 h:link 标记 .GET 请 
求 注 册页 面 registry. xhtml 和 主页 index. xhtml。 

(4) 对 登录 页 面 login. xhtml 的 “确定 ?按钮 ,采用 h:commandButton 标记 产生 POST 
请 求 ,然后 处 理 相 应 的 业务 功能 : 如 果 登 录 成 功 , 重 定向 至 主页 ;如 果 登 录 失 败 , 返 回 登 录 页 


» 123 3 


面 本 身 。 

(5) 对 注册 页 面 registry. xhtml 的 “登录 ”和 “返回 首页 ” 超 链接 ,采用 h:link 标记 .GET 
请 求 登录 页 面 login. xhtml 和 主页 index. xhtml。 

(6) 对 注册 页 面 registry. xhtml 的 “提交 ”按钮 ,采用 h: commandButton 标记 产生 
POST 请 求 ,然后 处 理 相应 的 业务 功能 : 如 果 注 册 成 功 , 重 定向 至 主页 ;如 果 注 册 失 败 , 返 回 
注册 页 面 本 身 。 
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第 6 章 页 面 布 局 与 数据 表格 


本 章 主题 : 

。 CSS 技 术 

。 面板 标记 

。 数据 表格 标记 
。 编辑 数据 表格 
。 分 页 显示 技术 


本 章 涉及 页 面 布局 与 数据 表格 两 个 话题 。 好 的 页 面 布局 与 设计 对 一 个 Web 应 用 来 说 
占有 举足轻重 的 地 位 。CSS 是 一 种 用 于 格式 化 页 面 的 标准 技术 ,可 以 实现 页 面 布局 和 设置 
内 容 显示 格式 等 功能 。 本 章 首先 介绍 CSS 的 定义 和 应 用 技术 ,但 有 关 CSS 属性 的 内 容 , 读 
者 可 参阅 其 他 图 书 ,本 书 不 做 专门 介绍 。 

在 Web 应 用 中 ,经 常会 出 现 要 显示 成 批 数据 的 情况 ,这 时 需要 用 到 数据 表格 组 件 。 表 
格 组 件 既 可 用 于 显示 数据 集 ,也 可 辅助 CSS 完成 页 面 布局 。 本 章 后 面 几 节 将 介绍 表格 等 相 
关 组 件 及 其 应 用 技术 。 


6.1 CSS 技 术 


CSS(Cascading Style Sheets , 层 释 样 式 表 ) 是 一 种 用 于 指定 网 页 呈现 格式 的 计算 机 语 
言 。 使 用 CSS 技术 的 优点 有 : 

(1) 网 页 的 呈现 内 容 与 呈现 格式 分 离 , 可 以 提高 网 页 代码 的 可 读 性 ; 

(2) 对 网 站 所 有 或 部 分 网 页 的 呈现 格式 进行 统一 的 定义 ,可 以 确保 网 站 具有 一 致 的 呈 
现 风 格 ; 

(3) 一 个 呈现 格式 信息 通常 会 被 一 个 网 页 或 多 个 网 页 反复 使 用 ,因此 可 以 减少 页 面 的 
代码 数量 ,提供 下 载 速度 ; 

(4) 网 站 所 有 或 部 分 网 页 的 呈现 格式 信息 集中 定义 ,便于 修改 和 维护 ,可 以 降低 网 站 的 
开发 和 维护 工作 量 。 


6.1.1 定义 CSS 


一 个 样式 表 由 若干 样式 组 成 ,每 个 样式 指定 一 组 表示 呈现 格式 的 属性 。 定 义 样式 的 一 
般 格式 如 下 : 


< 选择 符 > {< 样式 属性 名 > :< 属性 值 > ; .…} 


其 中 ,选择 符 指 定 该 样式 作用 的 对 象 。 样 式 属性 名 与 属性 值 之 间 用 冒号 (:) 分 隔 ,各 属性 名 
一 值 对 之 间 用 分 号 (;) 分 隔 , 最 后 一 个 分 号 可 以 省 略 。 下 面 介绍 一 些 常用 的 选择 符 。 
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1. 标记 选择 符 
格式 : 
< 标记 名 > {/ * 样式 属性 设置 * / } 


可 以 用 网 页 的 某 种 标记 的 名 称 作 为 选择 符 , 称 为 标记 选择 符 。 由 此 定义 的 样式 将 作用 
于 所 有 由 选择 符 指定 的 标记 的 呈现 。 
假设 有 如 下 样式 定义 : 


h3{color:blue; font-family: 黑 体 } 


那么 网 页 中 所 有 二 h3 之 … 所 /h3 之 之 间 的 文字 (3 级 标题 ) 用 蓝 色 .黑体 显示 。 
2. 类 选择 符 
格式 : 


.< 类 名 >{/* 样式 属性 设置 */ } 或 ”< 标记 名 > .< 类 名 >{/x 样式 属性 设置 x / } 


选择 符 可 以 由 点 号 (. ) 紧 跟 一 个 自 定 义 的 类 名 表示 , 称 为 类 选择 符 。 由 此 定义 的 样式 将 
作用 于 所 有 class 属性 值 为 指定 类 名 的 标记 的 呈现 。 

类 选择 符 前 面 可 以 包括 标记 名 ,此 时 的 样式 仅 作 用 于 class 属性 值 为 指定 类 名 的 特定 标 
记 的 呈现 。 

假设 有 如 下 样式 定义 : 

.cl{font-size:1l2px;letter- spacing:2px} 

p.c2{width:90%;background- color:blue} 
那么 网 页 中 所 有 class 属性 值 为 cl 的 标记 ,其 内 容 将 用 字体 大 小 12 像素 、 字 间距 2 像素 
显示 ;class 属性 值 为 c2 的 p 标记 ,呈现 时 的 段落 宽度 为 容器 宽度 的 90%% 、 背 景 颜 色 为 
蓝 色 。 

3. ID 选择 符 

格式 : 

#<id 值 >{/* 样式 属性 设置 * /} 


ID 选择 符 由 并 号 紧 跟 一 个 自 定义 的 id 值 组 成 。 由 此 定义 的 样式 将 作用 于 id 属性 值 为 
指定 id 值 的 标记 的 呈现 。 

假设 有 如 下 样式 定义 : 

#em{font-weight:blod} 


那么 id 属性 值 为 em 的 标记 的 内 容 将 以 粗 体 显示 。 
4. 属性 选择 符 
格式 : 


< 标记 属性 名 >=< 属 性 值 >] 或 ”< 标记 名 > [< 标记 属性 名 >=< 属 性 值 >] 


属性 选择 符 指定 网 页 标记 的 某 个 属性 及 属性 值 .前 面 也 可 以 包含 一 个 标记 名 。 由 此 定 
义 的 样式 将 作用 于 包含 指定 属性 及 属性 值 的 所 有 标记 或 特定 标记 的 呈现 。 
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假设 有 如 下 样式 定义 : 
input[type=password] {background- color:gray} 


那么 网 页 中 所 有 口令 域 将 以 灰色 背景 显示 。 
5. 伪 类 
格式 : 


:< 伪 类 名 > ”或 ”< 选择 符 >:< 伪 类 名 > 


伪 类 可 以 为 指定 标记 的 特定 状态 设置 样式 属性 。 标 记 由 选择 符 指定 ,状态 由 伪 类 名 指 
定 。 常 用 的 伪 类 名 有 : 

。 link: 未 被 访问 过 的 状态 ,只 能 用 于 带 href 属性 的 a 标记 。 

。 visited: 已 被 访问 过 的 状态 ,只 能 用 于 带 href 属性 的 a 标记 。 

。 hover: 鼠标 划 过 时 的 状态 。 

。， active: 鼠标 点 击 按 下 时 的 状态 。 

。 focus: 得 到 焦点 时 的 状态 。 

假设 有 如 下 样式 定义 : 

a:link {color:steelblue;text-decoration:none} 

a:visited {color:steelblue;text-decoration:none} 


a:hover {color:red;text-decoration:underline} 


input [type=text] :focus {background- color :whitesmoke} 


那么 页 面 中 未 被 访问 过 和 已 被 访问 过 的 超 链接 都 以 钢 青色 显示 且 没 有 下 划 线 ;鼠标 划 
过 的 超 链接 将 以 红色 显示 且 有 下 划 线 ;文本 域 组 件 聚焦 时 会 以 白 雾 色 作为 背景 颜色 。 
说 明 : 一 般 的 浏览 器 都 支持 关于 超 链 接 的 伪 类 ,但 对 其 他 标记 的 伪 类 并 不 一 定 支持 。 


6.1.2 使 用 CSS 


上 面 主要 介绍 如 何 定义 样式 ,本 节 将 介绍 样式 表 的 几 种 存在 方式 以 及 如 何 将 其 应 用 于 
页 面 及 其 元 素 。 

1. 定义 内 部 样式 表 

内 部 样式 表 定 义 于 页 面 内 ,其 样式 可 应 用 于 页 面 内 的 标记 。 内 部 样式 表 在 style 标记 内 
定义 ,而 style 标记 一 般 放置 在 页 面 的 head 标记 内 。 下 面 代码 演示 了 定义 内 部 样式 表 的 一 
般 格式 。 


<h:head> 
<style type="text/css"> 
RR 
Pp {font- size:12px;color:steelblue} 
.cone {font-family :楷体 gb2312;text-align:center} 
--> 
</style> 
</h:head> 


这 里 ,把 整个 样式 表 包 含 在 HTML 注释 内 ,可 以 避免 不 支持 CSS 的 浏览 器 把 样式 表 内 容 直 
二 


接 显示 出 来 。 而 对 于 支持 CSS 的 浏览 器 , 则 会 对 其 进行 分 析 , 并 将 其 中 的 样式 应 用 于 页 面 
中 的 相关 标记 。 由 于 CSS 已 成 为 一 种 标准 ,一 般 的 浏览 器 都 应 该 支持 CSS, 所 以 通常 也 可 
以 省 略 其 中 的 HTML 注释 标记 。 

2. 定义 内 联 样式 

这 里 ,内 联 样式 是 指 在 页 面 标记 的 style 属性 中 指定 的 样式 。 内 联 样 式 仅 作用 于 所 在 的 
标记 。 下 面 代码 演示 了 定义 内 联 样式 的 格式 。 


<h:outputLabel for="il" value=" 姓 名 : " style="font- size: 12px;font-family: 黑体 "/> 


<h:inputText id="il" size="10" style="font-size:12px;background-color: whitesmoke"/> 


内 联 样式 用 法 简单 ,其 应 用 效果 也 很 容易 观察 ,但 违背 了 CSS 技术 的 初衷 , 即 没有 将 要 
显示 的 内 容 和 内 容 的 显示 格式 分 离 , 所 以 内 联 样式 一 般 只 在 页 面 调试 时 使 用 。 另 外 ,内 联 样 
式 也 可 用 于 那些 需要 特殊 样式 的 标记 ,为 这 些 标记 指定 特定 的 样式 属性 ,或 用 它 覆 盖 普 通 样 
式 中 的 某 些 样式 属性 。 

3. 链接 外 部 样式 表 

内 联 样式 和 内 部 样式 表 都 不 能 很 好 地 体现 CSS 技术 的 优势 。 一 个 定义 好 的 样式 ,不 能 
仅仅 用 于 一 个 标记 或 一 个 页 面 ,而 是 应 该 能 用 于 所 有 需要 它 的 页 面 和 标记 。 

可 以 将 一 个 样式 表 定 义 保存 在 一 个 单独 的 文件 中 , 称 为 样式 表 文 件 。 样 式 表 文件 是 一 
个 文本 文件 ,其 扩展 名 应 该 为 . css。 

在 页 面 中 可 以 用 link 标记 链接 一 个 样式 表 文 件 。link 标记 用 于 在 当前 页 面 与 样式 表 文 
件 (或 其 他 外 部 文档 ) 之 间 建 立 连接 ,使 得 页 面 中 的 标记 可 以 使 用 被 链接 的 样式 表 中 的 样式 。 
与 定义 内 部 样式 表 一 样 ,link 标记 一 般 也 应 该 写 在 页 面 的 head 标记 内 。 下 面 代 码 演 示 了 链 
接 外 部 样式 表 的 方法 。 


</h:head> 
<link rel="stylesheet" type="text/css" href="css/cssone.css"/> 
</h:head> 


其 中 ,rel 属性 指定 当前 页 面 文档 与 被 链接 外 部 文档 之 间 的 关系 ,在 链接 样式 表 文 件 时 ,通常 
取 值 为 “stylesheet”;type 属性 指定 被 链接 外 部 文档 的 MIME 类 型 ,对 于 样式 表 文件 ,其 值 
总 是 “text/css”;href 属性 用 于 指定 外 部 样式 表 文 件 的 地 址 。 在 上 面 代 码 中 ,被 链接 的 样式 
表 文 件 cssone. css 应 该 存放 在 当前 页 面 所 在 目录 的 子 目 录 css 中 。 

一 个 样式 表 文件 可 以 被 多 个 页 面 文档 链接 。 反 过 来 ,一 个 页 面 也 可 以 链接 多 个 样式 表 
文件 。 一 个 页 面 除了 可 以 链接 外 部 样式 表 , 还 可 以 同时 用 style 标记 定义 内 部 样式 表 。 但 需 
要 注意 ,这 些 样 式 表 的 链 和 或 定义 的 先后 次 序 会 影响 其 中 的 样式 的 优先 级 。 

说 明 : 可 以 将 rel 属性 指定 为 “alternate stylesheet”, 并 通过 title 属性 指定 一 个 标题 。 
这 样 ,被 链接 的 外 部 样式 表 就 成 为 一 个 可 替换 的 样式 表 。 ep eee 定 标 题 来 
选择 要 应 用 于 页 面 的 样式 。Firefox、Opera 等 浏览 器 支持 这 种 交互 功能 。 

4. 导入 外 部 样式 表 

导入 外 部 样式 表 是 指 用 @import 符号 在 一 个 样式 表 中 链接 另 一 个 样式 表 。 也 就 是 说 

一 个 样式 表 除 了 能 定义 自己 的 样式 外 ,还 可 以 包含 男 一 个 样式 表 的 样式 ,但 @import 符号 
必须 出 现在 其 他 样式 定义 之 前 。 下 面 代码 演示 了 导入 外 部 样式 表 的 方法 。 
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<h:head> 
<style type="text/css"> 
天 
Qimport "css/cssone.css"; 
Qimport "css/csstwo.css"; 
p {font- size:12px;color:steelblue} 
--> 
</style> 
</h:head> 


这 个 代码 在 内 部 样式 表 中 导入 url 地 址 分 别 为 “css/cssone. css” 和 “css/csstwo. css” 的 两 个 
样式 表 。 除 了 可 用 于 内 部 样式 表 , @import 符号 也 可 用 于 外 部 样式 表 , 即 在 一 个 外 部 样式 
表 中 导入 另外 的 外 部 样式 表 。 

说 明 : link 是 一 个 HTML 标记 ,用 于 在 页 面 中 链接 一 个 外 部 样式 表 或 其 他 类 型 的 外 部 
文档 。@import 是 一 个 CSS 符号 ,用 于 在 一 个 样式 表 中 导入 另外 的 外 部 样式 表 。 

5. h:outputStylesheet 标记 

这 是 一 个 JSF HTML 标记 ,在 服务 器 端 表示 为 一 个 UIOutput 组 件 实例 ,相应 的 组 件 
族 名 为 Output, 相 应 的 呈现 器 型 名 为 resource. Stylesheet。 组 件 呈 现 为 一 个 HTML link 标 
记 , 用 于 在 JSF 页 面 中 链接 一 个 外 部 样式 表 。 

在 这 里 ,样式 表 被 看 作 是 一 种 资源 ,相应 的 样式 表 文 件 必 须 被 存放 在 JSF 应 用 文档 根 
目录 下 的 resources 目录 下 。 通 常 可 以 在 该 目录 下 创建 一 些 子 目录 ,这 些 子 目录 称 作 库 
(library) ,而 资源 则 可 存放 在 相应 的 库 中 。 

假设 resources 目录 下 有 一 个 名 为 css 的 子 目 录 ( 库 ), 其 中 存放 有 一 个 名 为 cssone. css 
的 样式 表 文 件 。 那么 应 用 中 的 任何 一 个 JSF 页 面 都 可 以 用 下 面 代 码 链 接 该 外 部 样式 表 。 


<h:outputStylesheet library="css" name="cssone.css"/> 


其 中 ,library 属性 指定 库 名 ,name 属性 指定 资源 名 。 

说 明 : JSF 提供 对 资源 库 或 单个 资源 的 版 本 控制 机 制 。 对 于 资源 库 的 版 本 控制 ,可 以 
在 库 目 录 下 建立 库 的 版 本 目录 ,而 该 库 的 不 同 版 本 的 资源 存放 在 相应 的 版 本 目录 下 。 比 如 
有 以 下 目录 和 样式 表 文 件 : 


resources/css/1 0/cssone.css 


resources/css/1 l/cssone.css 


那么 ,上 述 h:outputStylesheet 标记 会 链接 最 新 版 本 (1_1) 库 中 的 样式 表 文 件 cssone. css。 
对 于 单个 资源 的 版 本 控制 ,应 该 将 资源 名 作为 库 目录 下 的 子 目 录 名 .而 不 同 版 本 的 资源 
文件 则 用 版 本 号 命名 ,比如 : 


resources/css/cssone.css/1 0.css 


resources/css/cssone.css/1 1.css 


那么 ,上 述 h:outputStylesheet 标记 会 链接 资源 的 最 新 版 本 . 即 样 式 表 文 件 1_1. css。 版 本 
号 必须 是 下 划 线 分 隔 的 十 进 制 数字 , 按 正常 的 方式 比较 新 旧 。 
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6.1.3 CSS 应 用 示例 


本 应 用 项 目 (ch6_css) 主要 用 于 演示 CSS 样式 表 的 定义 与 使 用 。 应 用 包含 两 个 层 释 样 
式 文件 cssl. css 和 css2. css, 两 个 JSF 页 面 文件 index. xhtml 和 indexl. xhtml。 这 4 个 文 
件 的 存储 结构 如 图 6-1 所 示 。 图 -6 -ss 

这 里 ,页 面 index. xhtml 页 面 直接 通过 HTML 的 link 标 白 - 国 Web 页 
记 链 接 cssl. css 样式 表 , 而 页 面 indexl. xhtml 则 通过 JSF 由 - 回 WEB-INF 
HTML 的 h:outputStylesheet 标记 链接 css2. css 样式 表 。 日 加 css 

1. 页 面 index. xhtml 了 cssl. css 

该 页 面 用 到 cssl. css 层 释 样 式 表 。 先 来 看 一 下 这 个 样式 et 
表 的 内 容 , 见 代码 清单 6-1。 样 式 表 共 定义 了 两 个 样式 ,两 个 样 
式 都 指定 了 ( 块 级 ) 元 素 的 宽度 ,高度 和 内 部 文字 的 水 平 对 齐 方 二 AU 
式 。 其 中 ,第 1 个 样式 适用 于 标记 h3 和 class 属性 值 包含 “b1” index1. xhtml 
的 标记 ;第 2 个 样式 适用 于 class 属性 值 包含 *b2” 的 标记 p。 | 源 包 

代码 清单 6-1 css/essl. css 图 6-1 项 目 文件 存储 示意 图 


css2. css 


。h3, .bl1{ 
width: 400px; 
height: 30px; 


text-align: center; 


1 

2 

3 

4 
5。} 
6. p.b21{ 

7 width: 400px; 

8 height: 30px; 

9 text-align: right; 
10. 3 


页 面 index. xhtml 本 身 也 定义 了 一 个 样式 表 , 见 代码 清单 6-2。 其 中 ,第 1 个 样式 指定 
了 前 景 颜色 和 背景 颜色 ,适用 于 class 属性 值 包 含 “i1” 标 记 ; 第 2 个 样式 指定 了 文字 的 字体 ， 
适用 于 class 属性 值 包含 “i2” 的 标记 。 

代码 清单 6-2 index. xhtml 


. <?xml version='1.0' encoding='UTF-8' ?> 

.<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 

.<html xmlns="http://www.w3.0rg/1999/xhtml" 


1 
2 
3 
4 
5 xmlns:h="http://java.sun.com/jsf/html"> 
6 <h:head> 

3 <title>Css 应 用 示例 (一)</title> 

8 <link rel="stylesheet" type="text/css" href="css/cssl.css"/> 
9 <style type="text/css"> 

10. 下 下 和 


生生 color: white; 
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b background- color: gray7 


3 } 

EE a 

15. font- family: 楷体 gb2312; 
L6e } 

17。 </style> 


18. </h:head> 
19. <h:body> 


20. <h3 class= "il"> 块 级 标记 文字 1</h3> 

CU <span class="il"> 行 级 标记 文字 1</span> 

225 <h:outputText value=" 行 级 标记 文字 2" styleClass="i2"/> 
工交 <p class="b2 il"> 块 级 标记 文字 2< /p> 

24. <div class="bl i2"> 块 级 标记 文字 3</div> 

25. </h:body> 

26. </html> 


页 面 的 呈现 效果 如 图 6-2 所 示 。 以 最 后 一 行内 容 为 例 , 其 效果 是 由 外 部 样式 表 的 第 1 


个 样式 和 内 部 样式 表 的 第 2 个 样式 县 加 的 结果 。 


CSS 应 用 示例 (一 ) - oxilla Firefox 回回 加 


文件 @) 编辑 人 E) 查看 VW) 历史 G) 书签 @) 工具 () 帮助 0 


人 - 昌 - 加 http://localhost-8080/chB_css/ 


块 级 标记 文字 1 


块 级 标记 文字 3 


图 6-2 页 面 index. xhtml 呈现 效果 


2. 页 面 index1. xhtml 


该 页 面 用 到 css2. css 层 琶 样式 表 。 样 式 表 中 仅 定 义 了 一 个 样式 ,指定 了 前 景 颜色 .背景 


颜色 和 文本 对 齐 方 式 , 见 代码 清单 6-3 。 
代码 清单 6-3 resources/css/css2. css 


| 


color: white; 


1 
2 
入 background- color: gray7 
4 text-align: right 
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这， 


页 面 indexl. xhtml( 代 码 清单 6-4) 主 要 演示 块 在 其 容器 内 的 对 齐 方 式 ,以 及 文字 在 块 
内 的 对 齐 方式 。 页 面 内 共有 两 个 大 块 ,每 个 大 块 内 都 分 别 包 含 两 个 小 块 ,每 个 小 块 内 都 有 一 


段 文本 。 
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代码 清单 6-4 index1. xhtml 


1. <?xml version= '1.0' encoding= 'UTE-8' ?> 
.<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
.<html xmlns="http://www.w3.0rg/1999/xhtml" 

xmlns:h="http://java.sun.com/jsf/html"> 
<h:head> 

<title>Css 应 用 示例 (二)</title> 

<h:outputStylesheet library="css" name="css2.css"/> 

9. </h:head> 

10. <h:body> 


oauwww 


Ys <div style="margin: 10px 30px Opx 30px;border: solid gray"> 
12、 <div> 

Ys <h:outputText value= "1: 默 认 "/> 

14. </div> 

15, <div class="c"> 

16. <h:outputText value="1: 右 对 齐 "/> 

3s </div> 

18. </div> 

195 <div style="width:95%;margin: 10px auto 0px auto;border: solid gray"> 
20s <div> 

Se <h:outputText value="2: 默 认 "/> 

22。 </div> 

23. <div class="c"> 

-2 <h:outputText value="2: 右 对 齐 "/> 

255 </div> 

26. </div> 

27. </h:body> 

28. </html> 


页 面 的 呈现 效果 如 图 6-3 所 示 。 第 1 个 大 块 边框 与 其 上 面 标记 或 其 容器 上 沿 间距 为 
10px', 与 其 容器 右 沿 间距 为 30px, 与 其 下 面 标记 间距 0px,' 与 其 容器 左 沿 间距 为 30px。 这 一 
大 块 内 包含 上 下 两 个 小 块 , 两 个 小 块 的 宽度 是 其 容器 的 宽度 。 上 面 小 块 内 的 文字 采用 默认 
的 左 对 齐 , 下 面 小 块 内 的 文字 采用 右 对 齐 。 


) CSS 应 用 示例 (二 ) 一 ozilla Firefox 
文件 四) 编辑 E) 查看 WV) 历史 G) 书签 B) 工具 中 帮助 如 


B http://localhost-8080/ chB_css/faces/indexl. xhtnl 


图 6-3 页 面 indexl. xhtml 呈现 效果 
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第 2 个 大 块 指定 了 其 宽度 是 其 容器 宽度 的 95% ,其 边框 与 其 上 面 标记 的 间距 为 10px、 
与 其 下 面 标记 的 间距 为 0px。 其 边框 与 其 容器 左右 边框 的 间距 是 auto, 这 可 以 保证 该 块 在 
其 容器 内 可 水 平 居中 对 齐 。 该 大 块 内 的 情况 与 第 1 个 大 块 内 的 情况 类 似 。 

说 明 : HTML 标记 大 致 可 分 为 块 级 标记 和 行内 标记 两 大 类 。 块 级 标记 总 是 在 新 行 上 
显示 ,可 以 设置 高 度 (height) 宽度 (width) ,其 默认 宽度 通常 是 它 容器 的 宽度 。 块 级 标记 可 
以 包含 其 他 的 块 级 标记 和 行内 标记 。 常 见 的 块 级 标记 如 div、form、p、table、hl 等 。 行内 标 
记 和 其 他 行内 标记 显示 在 同一 行 上 , 它 不 能 设置 高 度 (height) 和 宽度 (width)。 行 内 标记 通 
常 只 能 包含 文本 和 其 他 行内 标记 。 常 见 的 行内 标记 如 a、br、input 等 。 


6.2 面 板 


面板 类 标记 主要 用 于 布局 。 面 板 类 标记 的 相应 组 件 类 有 共同 的 超 类 UIPanel, 在 该 超 
类 中 定义 了 这 些 组 件 共同 的 组 件 族 名 Panel。 


6.2.1 h:panelGrid 标记 


该 标记 在 服务 器 端 表示 为 一 个 HtmlPanelGrid 组 件 实例 ,其 呈现 器 型 名 为 Grid。 组 件 
呈现 为 一 个 HTML table 元 素 ,形成 一 个 由 单元 格 组 成 的 表格 ,每 个 单元 格 可 以 放置 一 个 子 
组 件 。 

在 标记 中 ,可 以 用 columns 属性 指定 表格 的 列 数 ,如 : 


<h:panelGrid columns="3"> 


</h:panelGrid> 


表格 的 行 数 由 columns 属性 指定 的 列 数 和 子 组 件 的 数目 共同 决定 。 比 如 对 于 上 述 3 列 
的 表格 ,假定 共有 10 个 子 组 件 ,那么 表格 呈现 为 4 行 ,其 中 最 后 一 行 只 有 一 个 子 组 件 。 各 子 
组 件 将 被 依次 从 上 向 下 、 从 左 到 右 放 置 在 表格 内 。 

h:panelGrid 标记 的 属性 较 多 , 除 id、rendered、style、styleClass 和 binding 等 基本 属性 
外 ,还 包含 许多 反映 表格 特点 的 属性 。 下 面 介绍 h:panelGrid 标记 的 常用 属性 。 

(1) columns: 设置 表格 的 列 数 ,int 型 。 默 认 值 为 1。 

(2) width: 设置 整个 表格 的 宽度 ,String 型。 一 般 块 级 元 素 的 默认 宽度 是 其 容器 的 宽 
度 ,但 表格 的 默认 宽度 则 由 其 各 数据 元 素 的 宽度 共同 决定 。 

(3) bgcolor: 设置 表格 的 背景 颜色 ,String 型 。 

(4) cellpadding: 指定 单元 格 内 空白 , 即 单元 格 边界 与 单元 格 内 容 之 间 的 间距 ， 
String 型 。 

(5) cellspacing: 指定 单元 格 间 空 白 , 既 指 单元 格 与 单元 格 之 间 的 间距 ,也 指 表格 边界 
与 单元 格 之 间 的 间距 ,String 型 。 

(6) frame: 指定 表格 四 条 边框 线 的 可 视 性 ,String 型 。 该 属性 的 有 效 值 包括 : 

。 none: 无 边框 线 ( 默 认 值 ) 。 

。 above: 仅 有 顶 框 。 
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。 below: 仅 有 底 框 。 

。 hsides: 仅 有 项 框 和 底 框 。 

。 lhs: 仅 有 左 侧 框 。 

。 rhs: 仅 有 右 侧 框 。 

。 vsides: 仅 有 左 侧 框 和 右 侧 框 。 

。 box border: 包含 全 部 四 条 边框 。 

(7) rules: 指定 表格 内 单元 格 边框 的 可 视 性 ,String 型 。 该 属性 的 有 效 值 包括 : 

。 none: 无 分 隔 线 (默认 值 )。 

。 groups: 仅 在 行 组 和 列 组 间 画 分 隔 线 。 

。 rows: 仅 有 行 分 隔 线 。 

。 cols: 仅 有 列 分 隔 线 。 

。 all: 包括 所 有 分 隔 线 。 

说 明 : 相 邻 的 边框 线 的 间距 由 cellspacing 属性 指定 。 相 邻 的 边框 线 也 可 以 合 二 为 一 ， 
这 时 需要 用 到 CSS 属性 bordercollapse。 若 该 属性 设置 为 separate, 则 相 邻 边框 线 是 分 离 
的 ; 若 属性 值 取 collapse, 那 么 相 邻 边框 线 将 合 二 为 一 。 

(8) border: 设置 表格 的 边框 宽度 (以 像素 为 单位 ) ,int 型 。 默 认 值 为 1。 

该 属性 的 设置 也 会 影响 frame 和 rules 属性 的 取 值 。 当 border 属性 设置 为 0 时 ,将 意 
味 着 frame 王 "none" ,除非 特别 设置 ,否则 rules 王 "none"。 当 border 属性 设置 为 非 0 时 , 除 
非特 别 设置 ,否则 意味 着 frame 二 "border" 和 rules 二 "all"。 

(9) columnClasses: 指定 作用 于 列 的 用 逗号 分 隔 的 CSS 样式 类 的 列表 ,列表 中 的 每 个 
样式 类 依次 作用 于 表格 中 的 列 。 

可 以 对 一 列 应 用 多 个 样式 类 ,这 些 样式 类 之 间 用 空格 分 隔 。 

(10) rowClasses: 指定 作用 于 行 的 用 逗号 分 隔 的 CSS 样式 类 的 列表 ,列表 中 的 每 个 样 
式 类 依次 作用 于 表格 中 的 行 。 如 果 样 式 类 的 数目 少 于 表格 行 数 ,那么 这 些 样 式 类 将 被 循环 
重复 使 用 。 

可 以 对 一 行 应 用 多 个 样式 类 ,这 些 样式 类 之 间 用 空格 分 隔 。 

6.2.2 h:panelGroup 标记 


用 于 将 一 些 组 件 归 组 ,以 便 它们 被 看 作 是 一 个 组 件 。 

h:panelGroup 标记 经 常 与 h:panelGrid 标记 一 起 使 用 。 在 表格 中 ,一 个 单元 格 通 常 只 
能 包含 一 个 组 件 。 如 果 要 包含 多 个 组 件 , 可 以 用 h:panelGroup 标记 对 它们 进行 归 组 。 反 过 
来 ,如 果 需 要 一 个 空白 单元 格 ,也 可 以 用 一 个 不 含 任何 子 标记 的 h: panelGroup 标记 填充 之 。 

该 标记 的 属性 较 少 。 除 id、style、styleClass、rendered 和 binding 等 其 他 大 多 数 标 记 都 
具有 的 基本 属性 外 ,该 标记 的 一 个 主要 属性 是 layout。 

该 标记 在 服务 器 端 表 示 为 一 个 HtmlPanelGroup 组 件 实例 ,其 呈现 器 型 名 为 Group。 

如 果 没 有 指定 style 或 styleClass 属性 ,组 件 呈 现时 将 直接 呈现 内 部 子 组 件 。 如 果 指 定 
了 style 或 styleClass 属性 、 且 layout 属性 取 block, 组 件 呈现 一 个 HTML div 标记 ;如 果 指 
定 了 style 或 styleClass 属性 .而 layout 属性 取 非 block 值 ,组 件 呈 现 一 个 HTML span 
标记 。 
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6.3 数据 表格 


本 节 介 绍 如 何在 页 面 中 使 用 数据 表格 ,包括 用 数据 表格 显示 一 个 数据 集 ,设置 表格 的 标 
题 \ 头 和 列 , 以 及 编辑 表格 数据 等 技术 。 


6.3.1 用 数据 表格 显示 数据 集 


用 数据 表格 显示 数据 集 , 主 要 涉及 h:dataTable 标记 和 h:column 标记 。 

h:dataTable 标记 在 服务 器 端 表 示 为 一 个 HtmlDataTable 组 件 实 例 ,其 组 件 族 名 为 
UIData, 旦 现 器 型 名 为 Table。 组 件 依据 要 显示 的 数据 集 以 及 相应 的 子 组 件 呈 现 一 个 数据 
表格 , 即 一 个 HTML table 标记 。 

h:column 标记 在 服务 器 端 表 示 为 一 个 HtmlColumn 组 件 实例 ,其 组 件 族 名 为 
UIColumn。 这 种 组 件 没有 相应 的 呈现 器 ,而 是 作为 HtmlDataTable 组 件 的 子 组 件 , 由 其 父 
组 件 相关 联 的 呈现 器 统一 呈现 。 

下 面 代码 演示 了 h:dataTable 标记 和 h:column 标记 的 用 法 。 


<h:dataTable value="# {bean.books}" var="book"> 


<h:column> 


<h:outputText value="# {book.title}"/> 
</h:column> 


<h:column> 


<h:outputText value="# {book.price}"/> 
</h:column> 
</h:dataTable> 


h:dataTable 标记 最 重要 的 属性 是 的 value 和 var 属性 。value 属性 指定 要 显示 的 数据 
集 。 这 个 数据 集 可 以 是 下 列 某 种 形式 ， 
。 一 个 Java 对 象 。 
。 一 个 数组 。 
。 一 个 java. util. List 对 象 。 
。 一 个 javax. faces. model. DataModel 对 象 。 
。 一 个 java. sql. ResultSet 对 象 。 
。 一 个 javax. servlet. jsp. jstl. sql. ResultSet 对 象 。 
。 一 个 javax. sql. RowSet 对 象 。 
虽然 value 属性 可 以 引用 单个 对 象 ,但 通常 引用 的 是 一 些 对 象 的 集合 或 者 是 数据 库 查 
询 的 结果 集 , 如 List 对 象 .ResultSet 对 象 等 。 当 标记 组 件 呈 现时 ,将 迭代 处 理 集合 中 的 每 
个 元 素 。 每 个 元 素 通常 被 呈现 为 数据 表格 中 的 一 行 。 
var 属性 指定 一 个 请 求 作用 域 的 名 称 ,用 于 表示 当前 被 处 理 的 元 素 对 象 ,就 如 一 个 bean 
名 称 表示 一 个 bean 实例 。 该 名 称 可 用 于 h:dataTable 标记 的 子 标记 内 的 EL 表达 式 中 。 
除了 value 和 var 属性 ,h:dataTable 标记 的 常用 属性 还 包括 : 
(1) first: 指定 从 数据 集 的 第 几 个 元 素 (索引 值 从 0 开始) 开始 迭代 处 理 和 呈现 。 默 认 
Ca 


值 为 0, 表示 从 首 行 开始 处 理 和 呈现 。 

(2) rows: 指定 要 处 理 和 呈现 的 元 素 个 数 ( 行 数 )。 若 为 0( 默 认 值 ), 则 处 理 和 呈现 数据 
集中 的 所 有 元 素 。 

(3) captionStyle: 指定 表 标 题 的 CSS 样式 。 

(4) captionClass: 指定 表 标 题 的 CSS 样式 类 。 

(5) headerClass: 指定 表 头 的 CSS 样式 类 ,多 个 样式 类 用 空格 分 隔 。 该 样式 类 作用 于 
表 中 所 有 表 头 。 

(6) footerClass: 指定 表 脚 的 CSS 样式 类 ,多 个 样式 类 用 空格 分 隔 。 该 样式 类 作用 于 
表 中 所 有 表 脚 。 

另外 , h: panelGrid 标记 中 介绍 的 除 columns 属性 外 的 其 他 属性 也 都 可 用 在 
h:dataTable 标记 中 。 

h:dataTable 标记 中 一 般 会 租 套 若干 个 h:column 子 标记 ,用 于 配置 数据 表格 中 的 列 。 
每 个 h:column 标记 扮演 了 特定 列 的 模板 ,其 内 容 对 将 要 处 理 和 呈现 的 每 个 元 素 对 象 进行 
重复 。 在 h:column 标记 内 ,一 般 需要 使 用 h:dataTable 标记 的 var 属性 指定 的 名 称 ,通常 
在 EL 表达 式 中 通过 该 名 称 访问 当前 元 素 对 象 的 某 个 数据 。 

h:column 标记 的 属性 较 少 , 除 id rendered 和 binding 等 基本 属性 外 ,主要 有 以 下 两 个 
属性 : 

(1) headerClass: 指定 该 列表 头 的 CSS 样式 类 。 

(2) footerClass: 指定 该 列表 脚 的 CSS 样式 类 。 


6.3.2 标题 、 表 头 和 表 脚 


上 面 h:dataTable 和 h:column 两 个 标记 的 有 关 属 性 都 涉及 表 标 题 或 表 头 和 表 脚 的 样 
式 设 置 ,这 里 介绍 如 何 设置 表 标题 . 表 头 和 表 脚 本 身 。 

表 标 题 通常 显示 于 表格 上 方 ,不 在 表格 的 单元 格 内 显示 。 表 头 显 示 于 表格 头 部 ,在 表格 
单元 格 内 显示 。 表 脚 显 示 于 表格 尾部 ,在 表格 单元 格 内 显示 。 

标题 ` 表 头 和 表 脚 都 是 通过 f:facet 核心 标记 来 配置 的 。f:facet 标记 用 来 为 其 父 组 件 和 
其 子 组 件 之 间 申 请 一 种 特殊 的 关系 ,其 仅 有 的 name 属性 用 于 指定 这 种 关系 。 

下 面 代码 演示 了 设置 表 标题 的 方法 。 其 中 f: facet 标记 应 该 直接 放置 在 h: dataTable 
标记 内 ,其 name 属性 取 *caption” ,表明 其 子 标记 (这 里 是 h:outputText 标记 ) 将 呈现 为 其 
所 在 表格 的 标题 。 


<h:dataTable …> 
<f:facet name="caption"> 
<h:outputText value=" 表 标题 "/> 
</f:facet> 


</h:dataTable> 
下 面 代码 演示 了 设置 表 头 和 表 脚 的 方法 。 要 设置 表 头 ,f:facet 标记 的 name 属性 应 设 
置 为 "header”; 要 设置 表 脚 ,f:facet 标记 的 name 属性 应 设置 为 “footer”。 


<h:dataTable value="# {bean.books}" var="book"> 
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<h:column> 
<f:facet name="header"> 
<h:outputText value=" 列 头 "/> 
</f:facet> 
#{book.title} 
<f:facet name="footer"> 
<h:outputText value=" 列 脚 "/> 
</f:facet> 
</h:column> 


</h:dataTable> 


上 面 设置 表 头 和 表 脚 的 f:facet 标记 都 放置 在 h:column 标记 内 ,这 样 的 表 头 、 表 脚 也 称 
为 列 头 、 列 脚 ,分 别 显 示 于 所 在 列 的 第 一 个 单元 格 和 最 后 一 个 单元 格 。 所 有 的 列 头 统称 为 表 
头 , 所 有 的 列 脚 统 称 为 表 脚 。 

用 于 设置 表 头 和 表 脚 的 f:facet 标记 也 可 以 放置 在 h:dataTable 标记 内 ,h:column 标记 
外 ,这 样 的 表 头 、 表 脚 将 横 跨 表格 所 有 的 列 。 

在 呈现 一 个 表格 时 ,首先 呈现 表 的 标题 ,然后 依次 呈现 横 跨 所 有 列 的 表 头 .从 属于 某 列 
的 表 头 ,接着 迭代 处 理 和 呈现 数据 集中 元 素 对 象 , 最 后 依次 呈现 从 属于 某 列 的 表 脚 、. 横 跨 所 
有 列 的 表 脚 。 


6.3.3 编辑 表格 


上 面 介绍 了 用 数据 表格 显示 数据 集 数据 的 方法 ,一 般 只 需 在 h:column 标记 内 放置 EL 
表达 式 或 h:outputText 子 标记 ,利用 它们 来 显示 数据 集中 当前 元 素 对 象 的 某 个 数据 。 

实际 上 ,不 仅 可 以 用 数据 表格 显示 数据 集 数据 ,也 可 以 用 数据 表格 编辑 数据 集 数据 。 要 
用 数据 表格 编辑 数据 集 数据 ,需要 在 h: column 标记 内 放置 h:inputText 等 输入 类 组 件 标 
记 , 以 便 能 显示 和 编辑 数据 集 数 据 ,然后 再 通过 动作 按钮 或 超 链接 提交 这 些 数据 。 当 然 ,这 
些 输入 类 组 件 和 动作 按钮 或 超 链 接 都 应 该 放置 在 表单 内 。 

另外 ,也 可 以 在 表格 中 设置 一 个 按钮 或 超 链 接 列 , 即 表 格 中 的 每 一 行 都 有 一 个 按钮 或 超 
链接 。 这 样 , 单 击 某 个 按钮 或 超 链接 就 可 以 对 所 在 的 行 (元 素 对 象 ) 进行 特定 的 操作 。 

下 面 通过 一 个 应 用 示例 介绍 表格 数据 的 编辑 。 该 JSF 应 用 项 目 (ch6_editanddelete) 包 
含 一 个 JSF 页 面 、 一 个 样式 表 文 件 .一 个 受 管 bean 和 两 个 普通 的 Java 类。 项 目 运行 时 页 面 
的 呈现 效果 如 图 6-4 所 示 。 

页 面 显示 购物 车 的 内 容 。 购 物 车 中 每 个 选 购 项 的 数量 可 以 修改 , 当 单 击 * 保 存 ? 按 钮 时 ， 
修改 的 结果 将 被 保存 到 购物 车 中 。 当 单 击 "删除 ? 超 链接 时 ,所 在 的 选 购 项 将 从 购物 车 中 删 
除 ,同时 其 他 选 购 项 的 修改 后 的 数量 也 会 进行 保存 。 

1. JSF 页 面 

该 应 用 项 目 唯一 的 JSF 页 面 index. xhtml 如 代码 清单 6-5 所 示 。 页 面 主要 包含 一 个 放 
置 在 表单 内 的 数据 表格 。 数 据 表 格 标记 (h:dataTable) 的 value 属性 绑 定 至 受 管 bean( 名 为 
tableData) 的 cart 属性 。cart 属性 的 类 型 为 List 二 Item 放 ,代表 一 个 购物 车 ,其 中 每 个 元 素 
的 类 型 为 Item, 代 表 一 个 选 购 项 。 
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ch6_editanddelete — Wozilla Firefox 
文件 FE) 编辑 人 E) 查看 WW) 历史 G) 书签 @) 工具 加 ) 


时 -BB -| http:/locdhost:8080/chs_editanddelete/ |e 


书 名 单价 数量 
计算 机 原理 29.501! | 


数据 库 原理 。 35.0o[L | 
计算 机 操作 系统 31. 50 [2 | 
Java 程 序 设计 。 33.501|1 | 


图 6-4 应 用 ch6_editanddelete 运行 效果 图 


代码 清单 6-5 index. xhtml 


OOoODp 


.<?xml version='1.0' encoding= 'UTE-8' ?> 
» < !DOCTYPE htm1l PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 


"http://www.w3.0rg/TR/xhtml1l/DTD/xhtmll-transitional.dtd"> 


.<html xmlns="http://www.w3.0rg/1999/xhtml" 


xmlns:h="http://java.sun.com/jsf/html" 
xmlns:f="http://java.sun.com/jsf/core"> 
<h:head> 
<title>ch6 editanddelete</title> 
<h:outputStylesheet library="css" name="style.css"/> 
</h:head> 
<h:body> 
<h:form> 
<h:dataTable value="#{tableData.cart}" var="item" headerClass="header" 
styleClass="data"> 
<h:column> 
<f:facet name="header"> 书 名 </f:facet> 
<h:outputText value="#{item.book.title}"/> 
</h:column> 
<h:column> 
<f:facet name="header"> 单 价 </f:facet> 
<h:outputText value="#{item.book.price}"/> 
</h:column> 
<h:column> 
<f:facet name="header"> 数 量 </f:facet> 
<h:inputText value="#{item.num}" styleClass="field"/> 
</h:column> 
<h:column> 
<h:commandLink value= "删除 " action="#{tableData.delete (item)}"/> 
</h:column> 
<f:facet name="footer"> 
<h:commandButton value=" 保 存 "action= "index?faces- redirect=true"/> 
</f:facet> 


36. 


这 里 , “删除 ” 超 链 接 指定 了 一 个 带 参数 的 方法 表达 式 , 而 “保存 ”按钮 并 没有 指定 方法 表达 
式 。 当 单 击 “ 保 存 ” 按 钮 时 ,所 有 的 表单 数据 ( 即 各 选 购 项 的 数量 ) 被 收集 并 提交 。JSF 框架 
在 处 理 请 求 时 ,这些 数据 将 被 读 和 人、 转换 、 验 证 ,并 更 新 模型 值 ( 即 各 选 购 项 的 数量 ), 最 后 再 


</h:dataTable> 
</h:form> 
</h:body> 
</html> 


次 呈现 该 页 面 。 
2. 样式 表 文 件 


该 应 用 项 目 仅 由 一 个 样式 表 文 件 , 如 代码 清单 6-6 所 示 。 其 中 样式 类 data 用 于 表格 内 
普通 数据 内 容 的 显示 ,样式 类 header 用 于 表格 内 列 头 的 显示 ,样式 类 field 用 于 表格 内 文本 


域 的 显示 。 
代码 清单 6-6 resources/css/style. css 


10. 
11。 


. .data { 


font-size: 14px 


1 
党 
3 

4. .header { 
5 
6 
7 
8 
9 


text-align: left; 


font-size: 14px 


.} 
». .field { 


width: 20px; 
font-size: 13px; 


} 


3. 受 管 bean 


本 应 用 仅 包含 一 个 受 管 bean 类 ,文件 名 为 TableData. java( 代 码 清 单 6-7)。 这 是 一 个 
会 话 作 用 域 的 受 管 bean, 包 含 一 个 只 读 属性 cart( 购 物 车 ), 属 性 值 在 bean 实例 被 创建 时 初 
始 化 。 该 受 管 bean 还 包含 一 个 带 参 数 的 动作 方法 delete(Item) ,会 在 用 户 单 击 页 面 上 的 


“删除 ”按钮 时 被 调用 。 
代码 清单 6-7 TableData. java 


OC oar Np 


. Package bean; 

. import java.math.BigDecimal; 

. import java.util.ArrayList; 

. import java.util.List; 

. import javax.faces .bean.ManagedBean; 

。 import javax.faces .bean.SessionScoped; 
. import source.Book; 

. import source.Item; 

. import java.io.Serializable; 

10. 
11, 


@ManagedBean 


@Sessionscoped 
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12. public class TableData implements Serializable { 


13. private List<Item>cart=new ArrayList<Item> (); 

14. 

15. public TableData(){ 

16. Item item; 

a item=new Item (new Book ("01", "计算 机 原理 ", new BigDecimal ("29.50")),1); 
18， cart .add (item); 

Ls item=new Item (new Book ("02", "数据 库 原 理 ", new BigDecimal ("35.00")),1); 
20。 cart .add (item); 

二 时 item=new Item(new Book ("03", "计算 机 操作 系统 ", new BigDecimal ("31.50")),2); 
2 cart .add (item); 

3 item=new Item(new Book ("04", "Java 程序 设计 ", new BigDecimal ("33.50")),1); 

24。 cart .add (item); 

25s } 

26. 

27. public List<Item>getCart(){ 

28 . return cart; 

29。 } 

30. public String delete(Item item){ 

31。 cart .removVe (item); 

32。 return "index?faces-redirect=true"; 

33， + 

34.} 

4. Java 类 


该 应 用 项 目 包含 两 个 普通 的 Java 类 ,都 存放 在 source 包 中 。 类 Book( 代 码 清 单 6-8) 表 
示 图 书 ,包含 3 个 只 读 属性 , 即 bookid( 编 号 ) \title( 书 名 ) 和 price( 单 价 )。 类 Item( 代 码 清 
单 6-9) 表 示 选 购 项 ,包含 一 个 可 读 写 属性 num( 数 量 ) 和 一 个 只 读 属 性 book( 图 书 ) 。 

代码 清单 6-8 Book. java 


. package source; 
. import java.io.Serializable; 


. import java.math.BigDecimal; 


. Public class Book implements Serializable { 


private String bookid; 
private String title; 


private BigDecimal price; 


public Book(){ 

} 

public Book (String bookid, String title,BigDecimal price){ 
this.bookid=bookid; 
this.title=title; 


this .price=price; 


EI 
18. public String getBookid(){ 


19。 return bookid; 

20, 1 

21. Ppublic String getTitle(){ 

22. return title; 

3 

24. public BigDecimal getPrice(){ 
Ss return price; 

26。 } 

P| 


代码 清单 6-9 Item. java 


. Package source; 


. import java.io.Serializable; 
. Public class Item implements Serializable{ 
private int num; 


2 

| 

4 

5. private Book book; 
6 

7 

8 public Item(Book book,int num){ 
9 


this.book=book; 


10. this.num=num; 

11s } 

12。 

a public int getNum(){ 
14. return num; 

5 } 

16. public void setNum(int num){ 
下 this .num=numy 

8s } 

Ly public Book getBook(){ 
205 return book; 

Rs 

22.} 


在 该 例 中 ,表格 中 “数量 ? 列 的 各 单元 格 是 h:inputText 标记 ,其 value 属性 指定 一 个 值 
表达 式 ;表格 最 后 一 列 的 各 单元 格 是 h:commandLink 标记 ,其 action 属性 指定 一 个 方法 表 
达 式 。 下 面 讨论 一 下 这 些 值 表达 式 和 方法 表达 式 的 计算 。 

在 呈现 数据 表格 时 ,对 于 数据 集 ( 购 物 车 ) 中 的 每 个 元 素 对 象 ( 选 购 项 ) 都 显示 对 应 的 表 
格 行 ,其 中 “数量 ” 列 的 单元 格 会 包含 一 个 HTML input 标记 ,EL 表达 式 “# {item. num) ”以 
右 值 模式 被 计算 ,结果 当前 选 购 项 的 数量 将 作为 input 标记 的 值 显示 于 单元 格 内 。 这 里 ， 
input 标记 会 与 当前 选 购 项 的 索引 值 相关 联 。 删 除 列 的 单元 格 显示 一 个 功能 与 提交 按钮 一 
样 HTML a 标 记 , 并 且 与 当前 选 购 项 的 索引 值 相 关联 。 
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当 单 击 “ 保 存 ” 按 钮 时 ,所 有 的 “数量 ” 值 被 提交 ,其 中 每 个 “数量 ” 值 与 一 个 索引 值 相 关 
联 。 在 服务 器 端 ,JSF 框架 会 根据 索引 值 找到 购物 车 中 相应 的 选 购 项 ,然后 以 左 值 模式 计算 
EL 表达 式 “# {item. num}”, 即 用 接收 到 的 “数量 值 去 更 新 选 购 项 的 对 应 属性 。 

当 单 击 某 个 “删除 ” 超 链接 时 ,同样 会 对 “数量 ” 值 进行 提交 ,并 更 新 模型 值 。 另 外 , 它 会 
在 “调用 应 用 ”阶段 调用 tableData 受 管 bean 的 delete 方法。 此 时 ,JSF 框架 会 根据 与 此 “ 删 
除 ? 超 链接 相关 联 的 索引 值 定位 选 购 项 ,并 用 该 选 购 项 作为 方法 调用 的 参数 。 


6.4 论坛 一 主题 表 与 回复 表 


本 节 继 续 5. 8 节 介 绍 的 应 用 项 目 (luntan_input) ,对 其 进行 功能 扩充 并 做 必要 的 修改 。 
为 保持 之 前 项 目的 独立 性 ,这 里 新 创建 一 个 名 为 luntan_table 的 JSF 应 用 项 目 , 并 从 原先 项 
目 复 制 所 有 的 JSF 页 面 、 源 包 中 的 所 有 Java 包 和 Java 类 。 

与 原先 的 应 用 项 目 luntan_input 相 比 ,新 的 应 用 项 目 luntan_table 主要 增加 了 以 下 功 
能 : 在 主页 上 增加 主题 表 、 并 对 整个 页 面 进行 布局 和 格式 化 ;在 “查看 回复 ”页 面 上 增加 回复 
表 、 并 对 整个 页 面 进行 布局 和 格式 化 。 

图 6-5 显示 了 该 应 用 的 运行 结果 。 图 6-5(a) 是 主页 页 面 ,页 面 原 有 的 元 素 都 还 存在 ,只 
是 进行 了 重新 布局 和 格式 化 。 页 面 下 方 添加 了 一 个 主题 表 , 每 个 主题 的 标题 是 一 个 超 链接 。 


loubuye/2012-8-31 下 午 3:58 loubuye/2012-6-31 下 午 3:58 
loubuye/2012-8-31 下 午 3:58 loubuye/2012-8-31 下 午 3:58 
loubuye/2012-8-31 下 午 3:58 loubuye/2012-8-31 下 午 3:58 
loubuye/2012-6-31 下 午 3:58 loubuye/2012-8-31 下 午 3:58 


文件 E) 编辑 FE) 查看 0) 历史 GG) 书签 @) 工具 中 帮助 00 


@ -3 [BB Mr/ocahost: B000/lontan table/ Eaces/shovheply. xhtnl?tid-1 


作者 :loubuye 发 表 于 :2012-8-31 下 午 3:58 


content_uuuuuuuuuu_1 


作者 :1oubuye 发 表 于 :2012-8-31 下 午 4:05 
好 的 页 面 布局 与 设计 对 一 个 Yeb 应 用 来 说 占有 举足轻重 的 地 位 。 


图 6-5 应 用 luntan_table 运行 效果 图 
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单 击 某 主题 的 标题 超 链接 ,会 在 一 个 新 窗口 打开 “查看 回复 ”页 面 。 图 6-5(b) 是 “查看 回复 ” 
页 面 , 该 页 面 同样 保留 了 原 有 的 元 素 , 但 进行 了 重新 布局 和 格式 化 。 页 面 下 方 是 新 添加 的 回 
复 表 ,回复 表 的 最 前 面 是 指定 主题 的 内 容 本 身 ,其 后 才 是 对 该 主题 的 回复 。 


6.4.1 扩充 模型 和 受 管 bean 


从 图 6-5 可 以 看 出 ,主题 表 和 回复 表 都 要 显示 主题 或 回复 的 创建 时 间 。 这 个 时 间 数 据 
的 类 型 是 java. util. Date, 在 显示 之 前 一 般 要 进行 相应 的 格式 化 。 另 外 ,回复 内 容 是 在 一 个 
文本 区 内 输入 的 ,期 间 换行 是 通过 按 Enter 键 实 现 的 。 按 Enter 键 相 当 于 插入 了 回 车 换行 
符 。 而 在 回复 表 中 ,回复 内 容 是 在 表格 的 一 个 单元 格 内 显示 的 ,其 中 回 车 换行 符 并 不 能 呈现 
为 换行 的 效果 ,因此 在 显示 之 前 需要 有 一 个 转换 的 过 程 。 

为 此 在 应 用 的 util 包 中 新 建 一 个 Formater 类 ,其 中 的 两 个 静态 方法 分 别 用 于 支持 完成 
上 述 格式 化 和 转换 任务 , 见 代 码 清单 6-10。 

代码 清单 6-10 Formater. java 


package util; 
import java.text.DateFormat; 


import java.util.Date; 


Ls 

2% 

3s 

4. 

5. public class Formater { 

6 public static String getTime (Date date){ 
录 return DateFormat .getDateTimeInstance (DateFormat .MEDIUM, 
8 DateFormat .SHORT) .format (date); 
9 } 


10. public static String getContent (String content){ 


Ls String str=content.replaceAll("\r\n","<br/>"); 

12 。 return str; 

Ls } 

14. } 

从 图 6-5 还 可 以 看 出 ,每 个 主题 都 有 一 个 业务 数据 : 点 击 数 。 当 用 户 单 击 主题 表 中 某 


主题 的 标题 超 链接 时 ,主题 的 点 击 数 就 应 该 增 1。 为 此 ,在 应 用 的 model 包 中 的 
TopicManager 类 中 添加 一 个 业务 方法 clickTopic(Topic) , 见 代码 清单 6-11。 当 用 户 单 击 主 
题 时 ,应 调用 该 方法 完成 相应 的 业务 处 理 。 

代码 清单 6-11 TopicManager 类 中 的 clickTopic(Topic) 方 法 


1. public void clickTopic(Topic topic)t{ // 主 题 的 点 击 数 增 1 
2. topic.setClickcount (topic.getClickcount ()+1)7 
3. } 


最 后 需要 扩充 受 管 bean, 它 扮演 着 连接 页 面 与 模型 的 桥梁 作用 。 作 为 支撑 主页 的 受 管 
bean ,bean. Index 类 需要 添加 showTime(Date) 方 法 和 click() 方 法 , 见 代 码 清单 6-12。 主 页 
可 以 通过 一 个 EL 方法 表达 式 调 用 showTime 方法 实现 时 间 数 据 的 格式 化 。click 是 一 个 动 
作 方 法 ,在 用 户 单 击 某 主题 的 标题 时 调用 。 
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代码 清单 6-12 ”为 bean. Index 类 新 添加 的 方法 


1 


1 
2 
3 
4 
5 
6. 
7 
8 
9 
0 


. public String showTime (Date date){ // 格 式 化 时 间 
return Formater .getTime (date) 

.} 

. Public String click(){ 

int tid=Integer.parseInt ((String)ELUtil .evalEL("#{param.tid}")); 
TopicManager tm=new TopicManager (); 

Topic t=tm.getTopicById (tid); 

tm.clickTopic (t); 

‘ return "showReply?faces-redirect=true&amp;tid="+tid; 

.} 


作为 支撑 “查看 回复 ”页 面 的 受 管 bean,bean. ShowReply 类 需要 添加 showTime(Date) 
和 showContent(String) 方 法 , 见 代 码 清单 6-13。“ 查 看 回复 ”页 面 可 以 通过 EL 方法 表达 式 
调用 这 两 个 方法 完成 时 间 数 据 的 格式 化 和 回复 内 容 的 转换 。 

代码 清单 6-13 ”bean. ShowReply 类 新 添加 的 方法 


EE 
2 
3。 
4 
5 
6 


6.4.2 


public String showTime (Date date){ // 格 式 化 时 间 数 据 
return Formater .getTime (date); 
} 
public String showContent (String content){ // 转 换 内 容 : 将 其 中 的 回 车 换行 替换 成 <br/> 
return Formater .getContent (Content) 7 


创建 样式 表 


该 应 用 新 建 了 一 个 外 部 样式 表 文 件 style. css, 见 代码 清单 6-14。 样 式 表 主 要 根据 主页 
和 “查看 回复 ”两 个 页 面 的 布局 和 格式 化 需要 建立 ,定义 了 它们 所 需 的 一 些 公 共 样 式 。 有 些 
标记 所 需 的 特殊 显示 格式 则 采用 内 联 样式 ,在 标记 的 style 属性 中 直接 指定 。 

代码 清单 6-14 resources/css/luntan_css. css 


o auwmwwN PP 


.fontl {font-size:14px} 

.font2 {font-size:14px; font-family: 黑 体 ; font-weight:normal} 
.font3 {font-size: 12px} 

text center {text-align:center} 

.text right {text-align:right} 

.text left {text-align:left} 

.bg_color {background-color:lightsteelblue} 
.marginl0 {margin:10px auto Opx auto} 
.margin0 {margin:0px auto Opx auto} 

.widthl00 {width:100%} 

.width95 {width:95%} 


.Word break {word-wrap:break-word;word-break:break-all;overflow:hidden} 


.a:link {color:teal;text-decoration:none} 
.a:visited {color:teal;text- decoration:none} 


.a:hover {color:red;text-decoration:underline} 


6.4.3 


修改 主页 


对 主页 index. xhtml 的 修改 ,首先 要 用 h:outputStylesheet 标记 链接 外 部 样式 表 , 然 后 
对 页 面 原 有 的 元 素 进行 格式 化 ,最 后 在 页 面 的 尾部 添加 主题 表 。 
该 页 面 布局 的 基本 思路 是 : 整个 页 面 由 一 些 从 上 到 下 排列 (间距 为 0 或 10px)、 宽 度 一 


样 (窗口 宽度 的 95%) 、 水 平 居 中 对 齐 的 块 组 成 。 


与 上 一 个 项 目的 主页 相 比 ,该 页 面 虽然 保留 了 原 有 的 元 素 ,但 由 于 格式 化 的 需要 ,页 
面 中 几乎 所 有 的 标记 都 有 所 改动 。 为 体现 整体 性 ,代码 清单 6-15 给 出 了 该 页 面 的 所 有 


代码 。 


代码 清单 6-15 ”主页 (index. xhtml) 


wamuwmwwNb PP 


.<?xml version='1.0' encoding= 'UTE-8' ?> 


.<!DOCTYPE html] PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 


"http://www.w3.0org/TR/xhtml1l/DTD/xhtmll-transitional .dtd" 


.<html xmlns="http://www.w3.0rg/1999/xhtml" 


xmlns:h="http://java.sun.com/jsf/html" 
xmlns:f="http://java.sun.com/jsf/core"> 
<h:head> 
<title> 轻 松 论坛 -- 主 页 </title> 
<h:outputStylesheet library="css" name="]luntan css.css"/> 
</h:head> 
<h:body> 


<h:form styleClass="marginl10 width95"> 


<h:panelGrid columns= cellspacing="5px" styleClass="fontl width100"> 
<h:panelGroup layout="block" styleClass="text left"> 
<h:outputText value= "注册 人 数 :# {index.numOfClient},"/> 
<h:outputText value= "在 线 人 数 :# {index.numofOnline}"/> 
</h:panelGroup> 
<h:panelGroup layout="block" styleClass="text right"> 
<h:commandLink value= "登录 " action="login" 
rendered="#{sessinfo.client==nul11}"/> 
<h:outputText value=" "/> 
<h:commandLink value= "注册" action="registry" 
rendered="#{sessinfo.client==nul11}"/> 
<h:outputText value="#{sessinfo.client.username}:" 
rendered="#{sessinfo.client!=nul1}"/> 
<h:commandLink value=" 退 出 " action="#{index.exit}" 
rendered="#{sessinfo.client!=nu11}"/> 
</h:panelGroup> 
</h:panelGrid> 


</h:form> 


<h:form styleClass="margin0 width95"> 
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<h:panelGrid columns="2" cellspacing="5px" styleClass="fontl width100"> 


<h:panelGroup layout="block" styleClass="text left"> 
<h:outputText value= "主题 数 :# {index.topics.size()}"/> 
</h:panelGroup> 
<h:panelGroup layout="block" styleClass="text right"> 
<h:commandButton value=" 新 建 主 题 " action="inputTopic?faces-redirect= 
true" styleClass="font3" disabled="#{sessinfo.client==nul1}"/> 
</h:panelGroup> 
</h:panelGrid> 
</h:form> 


<h:form styleClass="margin0 width95"> 
<h:dataTable value="#{index.topics}" var="topic" cellspacing="S5px" 
styleClass="fontl1 width100" 
headerClass="text left font2 bg color"> 
<h:column> 
<f:facet name="header"><h:outputText value=" 标 题 "/></f:facet> 
<h:commandLink value= 
"#{topic.title.length()>20?topic.title.substring(0,20) :topic.title}" 
action="# {index.click}" title="# {topic.title}" target="reply"> 
<f:param name= "tid" value="#{topic.id}"/> 
</h:commandLink> 
</h:column> 
<h:column> 
<f:facet name="header"><h:outputText value=" 回 复 / 点 击 "/></f:facet> 
<h:outputText value="#{topic.replycount}/#{topic.clickcount}"/> 
</h:column> 
<h:column> 
"创建 者 /时 间 "/></f:facet> 


#{topic.client.username}/"/> 


<f:facet name="header"><h:outputText value: 


<h:outputText valu 


<h:outputText value="#{index.showTime (topic.createtime)}" 
styleClass="font3"/> 
</h:column> 
<h:column> 
<f:facet name="header"><h:outputText value=" 最 后 回复 者 /时 间 "/></f:facet> 
<h:outputText value="#{topic.clientl.username}/"/> 
<h:outputText value="#{index.showTime (topic.lastreplytime)}" 
styleClass="font3"/> 
</h:column> 
</h:dataTable> 
</h:form> 


</h:body> 


-</html> 


6.4.4 ”修改 “查看 回复 "页面 


对 “查看 回复 ”页 面 showReply. xhtml 的 修改 ,其 过 程 和 布局 思路 与 修改 主页 的 基本 相 
同 。 代 码 清 单 6-16 给 出 了 该 页 面 的 所 有 代码 。 
代码 清单 6-16 showReply. xhtml 


1.<?xml version='1.0' encoding= 'UTE-8' ?> 

2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
3 "http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
4. <html xmlns="http://www.w3.0rg/1999/xhtml" 

Ss xmlns:h="http://java.sun.com/jsf/html" 

6 xmlns:f="http://java.sun.com/jsf/core"> 

7 
8 


<f:metadata> 


<f:viewParam name="tid" value="#{showReply.tid}"/> 
9。 <f:event type="preRenderView" listener="#{showReply.initView}"/> 
10. </f:metadata> 
11. <h:head> 
¥2, <title> 轻 松 论坛 -- 查 看 回复 < /title> 
Ek <h:outputStylesheet library="css" name="luntan css.css"/> 
14. </h:head> 


15. <h:body> 


16. <h:form styleClass="marginl0 width95"> 

hs <h:panelGrid columns="2" cellspacing="5px" styleClass="font1l width100"> 
18. <h:panelGroup layout="block" styleClass="text left"> 

和 <h:outputText value=" 回 复数 :# {showReply.replys.size()-1}"/> 

20. </h:panelGroup> 

2 <h:panelGroup layout="block" styleClass="text right"> 

225 <h:commandButton value= "回复 主题 " action="#{showReply. goReply}" 
2 styleClass="font3" disabled="#{sessinfo.client==null}"/> 
24. </h:panelGroup> 

5 </h:panelGrid> 

2 </h:form> 

27, 

28- <h:panelGroup layout="block" styleClass="margin0 width95"> 

29。 <h:panelGroup layout="block" styleClass="bg color font1l" 

30. style="margin- left:5px;margin- right:5px"> 
EF <h:outputText value=" 主 题 :#{showReply.topic.title}"/> 

Du </h:panelGroup> 

Rs </h:panelGroup> 

34. 

25 <h:panelGroup layout="block" styleClass="margin0 width95"> 

36. <h:dataTable value="#{showReply.replys}" var="reply" cellspacing="5px" 
3 styleClass="font]1 width100"> 

38 . <h:column> 

39, <h:panelGrid columns="2" cellspacing="0px" cellpadding="0px" 


“ I 


40 . styleClass="font3 width100"> 


41. <h:panelGroup layout="block"> 

42. <h:outputText value=" 作 者 :# {reply.client.username}"/> 

43. <h:outputText value=" 发 表 于 :#{showReply.showTime (reply.replytime)}"/> 
44. </h:panelGroup> 

45. <h:panelGroup layout="block" styleClass="text right"> 

46. <h:outputText value=" ##{showReply.replys.indexOf (reply)+1}"/> 
4 </h:panelGroup> 

48 . </h:panelGrid> 

49. <h:panelGroup layout="block" styleClass="word break" style="margin-top: 8px"> 
50. <h :outputText value="# {showReply .showContent (reply .content) }"escape="false"/> 
Sy。 </h:panelGroup> 

52。 <hr/> 

53。 </h:column> 

54. </h:dataTable> 

55 </h:panelGroup> 

56. </h:body> 

57. </html> 


6.5 论坛 一 分 页 显示 


在 Web 应 用 中 , 当 要 显示 大 型 数据 集 时 ,通常 会 利用 数据 表格 进行 分 页 显示 。 也 就 是 
说 ,每 次 传送 数据 集 的 一 部 分 数据 ( 即 一 页 数据 ) 至 客户 端 ,由 数据 表格 组 件 进行 呈现 ,并 提 
供 一 系列 页 码 超 链接 或 按钮 。 当 用 户 单 击 这 些 超 链接 或 按钮 时 ,将 转 而 呈现 上 一 页 、 下 一 页 
或 指定 页 的 数据 。 这 种 浏览 方式 直观 . 易 用 ,已 广泛 用 于 各 种 Web 应 用 。 

在 JSF 的 h:dataTable 标记 中 ,包括 first 和 rows 两 个 属性 , 它 使 得 标记 能 够 仅 显示 数 
据 集 的 一 部 分 数据 ,而 不 必 呈 现 数据 集 的 所 有 元 素 。 这 可 以 作为 实现 分 页 显示 功能 的 基础 。 
为 实现 分 页 显示 功能 ,通常 需要 引入 以 下 变量 : 

。 pageSize: 页 面 大 小 , 即 一 次 显示 几 个 元 素 ( 行 )。 

。 pageCount: 总 页 数 ,可 以 根据 数据 集 的 大 小 与 pageSize 计算 获得 。 

。 currentPage: 当前 页 码 。 该 变量 的 初 值 可 以 设置 为 1, 之 后 能 由 用 户 指定 。 

其 中 ,数据 集 的 大 小 一 般 可 以 调用 其 size() 方 法 获得 。 这 样 , 当 用 户 指定 某 个 当前 页 码 
时 ,很 容易 就 可 以 计算 出 所 需要 的 first 和 rows 属性 值 : 


first=pageSizex*x (currentPage-1) 

rows=pageSize 

下 面 继续 6. 4 节 介 绍 的 应 用 项 目 (luntan_table) .对 其 进行 功能 扩充 并 做 必要 的 修改 。 
为 保持 之 前 项 目的 独立 性 ,这 里 新 创建 一 个 名 为 luntan_pagination 的 JSF 应 用 项 目 , 并 从 
原先 项 目 复制 所 有 的 样式 表 文 件 JSF 页 面 、 源 包 中 的 所 有 Java 包 和 Java 类 。 

与 原先 的 应 用 项 目 luntan_table 相 比 ,新 的 应 用 项 目 luntan_pagination 主要 为 主页 中 
的 主题 表 和 “查看 回复 ”页 面 中 的 回复 表 增 加 了 分 页 显示 的 功能 。 图 6-6 显示 了 该 应 用 的 运 
行 结果 ,其 中 : 图 6-6(a) 是 主页 的 呈现 效果 ,图 6-6(b) 是 “查看 回复 ”页 面 的 呈现 效果 。 
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加 
文件 FE) 编辑 E) 查看 WW) 历史 G) 书签 中 工具 ID) 帮助 0D 登 


日 http://localhost:8080/lantan_paginationy faces/login xhtal 站 | 


loubuye: 退出 


loubuye/2012-8-31 下 午 4:14 。 loubuye/2012-6-31 下 午 4:14 
loubuye/2012-8-31 下 午 4:14 。 loubuye/2012-6-31 下 午 4:14 


作者 :1oubuye 发 表 于 :2012-6-31 下 午 4:14 


content_Uuuuuuuuuu_1 


作者 :loubuye 发 表 于 :2012-8-31 下 午 4:17 
好 的 页 面 布局 与 设计 对 一 个 ¥eb 应 用 来 说 占有 举足轻重 的 地 位 。 


(b) 
图 6-6 应 用 luntan_pagination 运行 效果 图 


6.5.1 创建 辅助 类 


首先 创建 一 个 Pager 辅助 类 ,集中 定义 涉及 分 页 显示 功能 的 数据 处 理 。 该 类 定义 在 应 
用 的 util 包 中 ,具体 代码 如 代码 清单 6-17 所 示 。 
代码 清单 6-17 util. Pager 


1. package util; 
2. import java.util.ArrayList; 
3. import java.util.List; 
4. 
5. public class Pager { 
6. private int pageCount; // 总 页 数 
7. private int currentPage=1; // 当 前 页 码 
8. Pprivate int showPages; // 连 续 页 码 超 链接 数 
9. private List<Integer>pages; 
10. 


11. public void setPageCount (int pageCount){ 
12, this.pageCount=pageCount; 
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3.。 
14. 
5 
16, 
17, 
18. 
9; 
20. 
21. 
22. 
235 
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25. 
26. 
2 
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30 。 
S31s 
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33 . 
34. 
35» 
36. 
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38 . 
39 . 
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41. 
42. 
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44. 
45. 
46. 
47. 
48. 


} 
public int getPageCount (){ 
return pageCount; 
} 
public void setShowPages (int showPages){ 
this.showPages=showPages; 
} 
public int getCurrentPage (){ 
return currentPage; 
public void setCurrentPage (int currentPage){ 
this.currentPage=currentPage; 
} 
public List<Integer>getPages (){ 
return pages; 
} 
// 根 据 当 前 页 码 、 总 页 数 和 连续 页 码 超 链接 数 构建 用 于 产生 页 码 超 链接 的 页 码 表 
public void init(){ 
if(pageCount>0){ 
if(currentPage<1) currentPage=1; 


if(currentPage>pageCount) currentPage=pageCount; 


int startPage=currentPage- (showPages-1)/2; // 初 步 的 最 小 页 码 
int endPage=currentPage+showPages/2; // 初 步 的 最 大 页 码 
int s=0; // 最 小 页 码 的 偏差 


if(startPage<1){ 
s=-startPaget+1; 
startPage=1; 
} 
int e=0; // 最 大 页 码 的 偏差 
if (endPage>pageCount){ 
e=endPage-pageCount; 
endPage=pageCount; 
, 
startPage=Math.max (startPage-e,1); // 用 最 大 页 码 的 偏差 去 调用 最 小 页 码 
endPage=Math.min (endPage+s,pageCount); // 用 最 小 页 码 的 偏差 去 调用 最 大 页 码 
pages=new ArrayList<Integer> (); 
for (int i=startPage;i<=endPage;i++){ 
pages.add (i); 
} 
System.out .Println(startPage+"， "+endPage) 7 


在 该 应 用 中 ,分 页 显示 功能 主要 是 为 用 户 提供 一 系列 的 超 链接 ,用户 单 击 超 链接 可 以 指 
定 所 需 数据 页 的 页 码 。 这 些 超 链接 除 包 括 前 (<)、 后 (之 )、 第 1 页 页 码 和 最 后 一 页 页 码 , 还 
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包括 含 当 前 页 码 在 内 的 连续 的 若干 个 页 码 ,这 个 连续 的 若干 个 页 码 超 链接 的 数量 是 可 以 设 
置 的 。 这 里 ,当前 页 码 不 呈现 为 超 链 接 ; 如 果 当 前 页 是 第 1 页 ,那么 "前 (所 )” 不 呈现 为 超 链 
接 ; 如 果 当 前 页 是 最 后 一 页 ,那么 “后 ( 盖 )” 不 呈现 为 超 链接 。 
该 类 的 init 方法 会 根据 当前 页 码 .总 页 数 和 连续 页 码 超 链接 数 构 建 相 应 的 页 码 表 。 该 
页 码 表 应 包含 当前 页 码 。 在 页 面 呈 现时 ,当前 页 码 会 呈现 为 普通 文本 ,而 其 他 页 码 则 呈现 为 
Pager 类 不 包含 数据 集 ,也 不 包括 页 面 大 小 (pageSize) 。 这 些 属 性 放置 在 支撑 页 面 呈 现 
的 受 管 bean 中 。 一 个 需要 分 页 显示 数据 集 的 页 面 的 支撑 bean 应 该 扩展 Pager 类 。 


6. 5.2 修改 主页 


首先 需要 修改 支撑 主页 呈现 的 受 管 bean 类 , 即 Index. java。 对 它 的 修改 包括 以 下 几 个 
方面 : 

(1) 将 bean 的 作用 域 改 为 会 话 作用 域 。 

(2) 让 该 bean 类 扩展 util. Pager 类。 

(3) 增加 一 个 只 读 的 pageSize 属性 。 该 属性 的 值 可 以 根据 需要 设置 。 根 据 该 属性 和 数 
据 集 的 大 小 可 以 计算 出 总 页 数 。 

(4) 增加 一 个 私有 的 loadData() 方 法 ,用 于 装 人 主题 数据 。 同 时 修改 构造 方法 。 

(5) 增加 initView() 方 法 。 该 方法 是 一 个 preRenderView 事件 监听 方法 ,其 功能 是 ， 
装 人 主题 数据 ,设置 pageCount 和 showPages 属性 ,然后 调用 init 方法 构建 页 码 表 。 

代码 清单 6-18 列 出 该 类 所 作 的 变动 。 

代码 清单 6-18 ”bean. Index( 部 分 ) 


1. @ManagedBean 
2. QSessionScoped 
3. public class Index extends Pager implements Serializablef{ 
4 public Index(){ 
i loadData(); 
6 } 
7 private void loadData(){ 
8 TopicManager tm=new TopicManager (); 
9 topics=tm.getTopics (); 
10. } 
11。 。。oe 
12. private int pageSize=2; // 可 根据 需要 设置 初 值 
3 public int getPageSize(){ 
14. return pageSize; 
15。 } 
16. public void initView(){ 
17。 if (getCurrentPage ()==1) loadData(); 
EE int pc= (int)Math.ceil (topics.size() *1.0/pageSsize); 
LE setPageCount (pc); 
20. setShowPages (8); // 设 置 showPages 属性 
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如 果 分 页 显示 数据 集 且 要 对 显示 的 数据 元 素 做 某 些 操作 ,如 通过 文本 域 进行 编辑 修改 、 
通过 动作 类 组 件 产生 动作 事件 ,那么 一 般 应 该 将 其 对 应 的 受 管 bean 设置 为 会 话 作 用 域 ,以 
便 该 受 管 bean 在 请 求 时 的 状态 与 之 前 页 面 呈现 时 的 状态 相同 。 这 样 ,请 求 参 数 才 能 被 正确 
接收 和 处 理 。 

由 于 该 受 管 bean(bean. Index) 被 设置 成 会 话 作 用 域 了 ,所 以 在 整个 会 话 期 间 , 该 bean 
实例 只 被 创建 一 次 。 但 主题 数据 是 会 不 断 更 新 的 ,不 仅 用 户 自己 会 创建 主题 ,其 他 用 户 也 会 
发 表 主 题 。 那 么 如 何 为 用 户 更 新 主页 上 呈现 的 主题 数据 呢 ? 这 里 没有 采取 每 次 呈现 都 刷新 
的 策略 ,而 是 在 每 次 呈现 主题 表 的 第 1 页 数据 时 才 为 用 户 重新 装 入 主题 数据 。 

接着 修改 主页 , 即 index. xhtml 文件 。 对 主页 的 修改 包括 三 个 方面 : 

(1) 增加 视图 参数 p, 并 指定 preRenderView 事件 的 监听 方法 。 

视图 参数 用 于 接收 用 户 指 定 的 当前 页 码 , 接 收 到 的 当前 页 码 应 保存 到 currentPage 属 
性 中 。preRenderView 事件 的 监听 方法 应 设置 为 受 管 bean 的 initView 方法 。 

(2) 为 h:dataTable 标记 添加 first 和 rows 属性 。 

(3) 在 页 面 尾部 添加 产生 页 码 超 链 接 的 代码 。 

代码 清单 6-19 列 出 该 页 面 文件 所 作 的 变动 。 其 中 ,最 后 部 分 产生 页 码 超 链接 的 代码 要 
用 到 Facelets 标记 库 中 ui:repeat 标记 。nui: repeat 标记 可 以 对 数组 或 表 中 的 元 素 进行 迭代 
处 理 和 呈现 。Facelets 标记 库 在 本 书 第 10 章 会 有 详细 介绍 。 

代码 清单 6-19 index. xhtml( 部 分 ) 


<html xmlns="http://www.w3.0rg/1999/xhtml" 
xmlns:h="http://java.sun.com/jsf/html" 
xmlns:f="http://java.sun.com/jsf/core" 


xmlns:ui="http://java.sun.com/jsf/facelets"> 


<f:viewParam name="p" value="#{index.currentPage}"/> 
<f:event type="preRenderView" listener="#{index.initView}"/> 


Ls 

2 

3 

4 

5. <f:metadata> 
6 

村 

8 </f:metadata> 
和 


<h:head> 
ER <title> 轻 松 论坛 -- 主 页 </title> 
Ly <h:outputStylesheet library="css" name="]luntan css.css"/> 


12. </h:head> 
13. <h:body> 


d,s 

5s <h:form styleClass="margin0 width95"> 

16. <h:dataTable value="#{index.topics}" var="topic" cellspacing="S5px" 
站 first="#{index.pageSize* (index.currentPage-1)}" rows="#{index.pageSize}" 
18 . styleClass="font1 width100" 

Ys headerClass="text left font2 bg color"> 

20. ee 


21， 
225 
23。 
2 
25。 
26。 
27。 
28. 
29. 
30 . 
31. 
2s 
33 . 
34. 
35 .。 
36. 
37。 
38 . 
39s 
40. 
41. 
42. 
43. 
44. 
45. 
46. 
47. 
48 . 
49. 
50 . 
51。 
52 
53, 
54. 
55 。 
56 . 


</h:dataTable> 


</h:form> 


<h:panelGroup layout="block" styleClass="margin10 text center"> 
<h:link value="g&lt;" disabled="#{index.currentPage le 1}" 
outcome="index?p=#{index.currentPage-1}" includeViewParams="true"/> 
&nbsp; 
<h:panelGroup rendered="#{index.pages[0] gt 1}"> 
<h:link value="]1" outcome="index?p=1" includeViewParams="true"/> 
&nbsp7 
</h:panelGroup> 
<h:panelGroup rendered="#{index.pages[0] gt 2}"> 
<h:outputText value="..."/> 
&nbsp; 
</h:panelGroup> 


<ui:repeat value="# {index.pages}" var= 
<h:link value="#{i}" disabled="true" style="background- color: silver" 
includeViewParams="true" rendered="#{i==index.currentPage}"/> 
<h:link value="#{i}" outcome="index?p=#{i}" includeViewParams= "true" 
rendered="#{i!=index.currentPage}"/> 
&nbsp; 
</ui:repeat> 
<h :panelGrouprendered="# {index .pages [index .pages .size ()-1]ltindex .pageCount -1}"> 
<h:outputText value="..."/> 
&nbsp; 
</h:panelGroup> 
<h:panelGrouprendered= "# {index .pages [index .pages .size ()-1]1tindex .pageCount }"> 
<h:link value="#{index.pageCount}" outcome="index?p=# {index .pageCount}" 
includeViewParams="true"/> 
&nbsp; 
</h:panelGroup> 
<h:link value="&gt;" outcome="index?p=#{index.currentPage+1}" 
disabled= "# { index . currentPage ge index .pageCount } " includeViewParams= "true"/> 
</h:panelGroup> 


</h:body> 


57. </html> 


在 这 里 ,实现 翻 页 功能 的 页 码 超 链接 都 是 用 结果 超 链 接 标 记 h:link 生成 的 ,所 以 单 击 
它们 都 将 产生 一 个 GET 请 求 。 


6.5.3 修改 “查看 回复 ”页 面 


首先 需要 修改 支撑 该 页 面 呈 现 的 受 管 bean 类 , 即 ShowReply. java。 与 修改 bean. 
Index 类 相似 ,对 该 类 的 修改 包括 3 个 方面 : 
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(1) 让 该 bean 类 扩展 util. Pager 类 。 

(2) 增加 一 个 只 读 的 pageSize 属性 。 

(3) 修改 bean 类 中 原 有 的 initView () 方 法 ,在 其 尾部 添加 设置 pageCount 和 
showPages 属性 以 及 调用 init 方法 的 代码 。 该 方法 是 一 个 preRenderView 事件 监听 方法 。 

代码 清单 6-20 列 出 该 类 所 作 的 变动 。 

代码 清单 6-20 ”bean. ShowReply. java( 部 分 ) 


1. public class ShowReply extends Pager!{ 
.es 


3 public void initView(){ 
i 
5 int pc= (int)Math.ceil (replys.size() *1.0/pageSize); 
6. setPageCount (pc); 
E/ setShowPages (8); 
8 init (); 
EE } 
0% aves 
11。 private int pageSize=2; 


12. public int getPageSize(){ 
Ee return pageSize; 

14. } 

5 


最 后 需要 修改 “查看 回复 ”页 面 本 身 , 即 showReply. xhtml 文件 。 与 修改 index. xhtml 
文件 类 似 , 对 该 页 面 文件 的 修改 也 包括 三 个 方面 : 

(1) 增加 视图 参数 p, 用 于 接收 用 户 指定 的 当前 页 码 , 接 收 到 的 当前 页 码 应 保存 到 
currentPage 属性 中 。 

(2) 为 h:dataTable 标记 添加 first 和 rows 属性 。 

(3) 在 页 面 尾部 添加 产生 页 码 超 链 接 的 代码 。 

由 于 相关 修改 代码 与 修改 主页 index. xhtml 时 的 基本 类 似 , 这 里 不 再 列 出 。 


6.6 小 结 


。 定义 样式 的 一 般 格式 : 二 选择 符 二 {二 样式 属性 名 二 :二 属性 值 二 >;……} ,其 中 选择 
符 可 以 是 : 标记 选择 符 、 类 选择 符 、ID 选择 符 、 属 性 选择 符 和 伪 类 等 。 
。 使 用 样式 或 样式 表 的 方式 包括 : 定义 内 部 样式 表 、 定 义 内 联 样式 、 链 接 外 部 样式 表 、 
导入 外 部 样式 表 、 用 h:outputStylesheet 标记 链接 外 部 样式 表 。 
h:panelGrid 标记 呈现 为 一 个 HTML table 元 素 . 主 要 用 于 页 面 布局 。 
。 h:panelGroup 标记 经 常 与 h:panelGrid 标记 一 起 使 用 ,用 于 将 一 些 组 件 归 组 ,以 便 
它们 被 看 作 是 一 个 组 件 放置 在 表格 的 一 个 单元 格 内 。 
。 h:dataTable 标记 呈现 为 一 个 HTML table 元 素 . 主 要 用 于 显示 数据 表格 。 其 value 
属性 可 以 指向 一 个 数组 或 集合 ,标记 会 迭代 处 理 ( 呈 现 ) 数 组 或 集合 的 每 个 元 素 。 其 
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4. 


var 属性 用 于 暴露 一 个 变量 ,该 变量 指向 当前 正在 处 理 的 元 素 。 

h:dataTable 标记 中 一 般 会 嵌 套 若干 个 h:column 子 标记 ,用 于 配置 数据 表格 中 
的 列 。 

f:facet 标记 可 以 包含 一 个 组 件 , 其 本 身 可 能 套 于 h:dataTable 标记 。 通 过 对 f:facet 
标记 的 name 属性 的 设置 ,其 子 组 件 可 被 作为 表格 的 标题 . 表 头 和 表 脚 。 


习 题 6 


1. 简 述 使 用 CSS 技术 的 优点 。 
2 
3. 简 述 h:panelGroup 标记 的 功能 及 其 layout 属性 的 用 法 。 


简 述 h:outputStylesheet 标记 的 功能 与 用 法 。 


分 别 比 较 下 面 各 组 属性 中 各 属性 的 作用 与 用 法 。 


(1) columnClasses .rowClasses 


(2) cellpadding .cellspacing 


(3) captionClass ,headerClass 


(4) frame ,rules 


5. 


利用 CSS 和 h:panelGrid 标记 等 技术 .对 第 4 章 习 题 5 的 sh4_logandreg 应 用 项 目 


中 的 各 页 面 进行 布局 和 格式 化 ,以 达到 满意 的 呈现 效果 。 


6; 


创建 JSF 应 用 sh6_lookandbuy。 该 应 用 包括 3 个 JSF 页 面 .若干 受 管 bean 类 和 模 


型 类 ,实现 图 书 的 检索 、 浏 览 与 选 购 功能 。 请 按 下 列 步骤 完成 应 用 开发 。 

(1) 在 “ 源 包 ”中 创建 4 个 Java 包 : bean、entity、model 和 util。 

(2) 在 entity 包 中 ,创建 一 个 表示 图 书 的 Java 类 Book。 下 面 是 该 类 的 不 完整 代码 ,请 
完善 之 。 


public class Book { 


private String bookid; // 图 书 编号 (每 本 书 的 图 书 编号 是 唯一 的 ) 
private String title; // 书 名 
private String author; // 作 者 
private String publisher; // 出 版 社 
private BigDecimal price; // 单 价 
private String isbn; //ISBN 号 
private String banci; // 版 次 
private String yinci; // 印 次 
private String kaiben; // 开 本 
private String yeshu; // 页 数 
private String zishu; // 字 数 
private String zhuzhen; // 装 帧 


public Book (){ } 
Public Book (String bookid){ 
// 初 始 化 实例 变量 
} 
public Book (String bookid, String title,String author,String publisher, 
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BigDecimal price,String isbn){ 
// 初 始 化 实例 变量 
和 
/x 
x* 为 各 实例 变量 提供 相应 的 getter 和 setter 方法 
*/ 
public boolean equals (Object object){ 
// 若 参数 是 一 个 Book 实例 且 其 bookia 值 与 当前 图 书 的 bookid 相等 ,返回 true; 
// 和 否则 返回 false 


下 


(3) 在 model 包 中 创建 一 个 DataBase 类 ,用 于 存放 图 书 数据 。 下 面 是 该 类 的 不 完整 代 
码 ,请 完善 之 。 


Public class DataBase { 
Private static final List<Book>books=new ArrayList<Book> (); 
statict{ 
// 初 始 化 books: 添加 10 至 20 本 图 书 
} 
public static List<Book>getBooks (){ 


return books; 


} 


(4) 在 util 包 中 ,创建 一 个 与 JSF 应 用 sh4_logandreg 中 一 样 的 Java 类 ELUtil。 然 后 
再 创建 一 个 用 于 实现 分 页 显示 功能 的 Java 类 Pager( 参 见 第 6.5 节 例 子 ) 。 

(5) 在 model 包 中 创建 一 个 表示 选 购 项 的 Java 类 Item。 下 面 是 该 类 的 不 完整 代码 ,请 
完善 之 。 


public class Item implements Serializable{ 
private Book book; 
private int sl; // 数 量 
/ 关 
* 为 各 实例 变量 提供 相应 的 getter 和 setter 方法 
*/ 
public void add(int n){ 
// 当 前 选 购 项 的 数量 增加 n; 
} 
hl 


(6) 在 model 包 中 创建 一 个 实现 图 书 管理 业务 的 BookManager 类 。 下 面 是 该 类 的 软 
件 接口 ,请 实现 之 。 


Public class BookManager { 


// 根 据 图 书 编号 返回 相应 的 图 书 。 如 果 不 存在 相应 的 图 书 , 返 回 nul1 
public Book findBookByBh (String bh); 
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// 返 回 所 有 图 书 
public List<Book>queryBook (); 
// 查 询 书 名 中 包含 指定 字符 串 的 图 书 
public List<Book>queryBook (String sm); 
} 
(7) 在 bean 包 中 创建 一 个 受 管 bean: 名 称 为 sessionBeanl 、 类 名 为 bean. SessionBeanl 、 作 
用 域 为 会 话 作 用 域 。bean 类 中 定义 一 个 可 读 写 的 List<Item 之 型 属性 cart。 该 属性 的 一 个 
元 素 表示 客户 的 一 个 选 购 项 ,其 初 值 是 一 个 空 的 ArrayList< Item 之 表 。 
(8) 创建 JSF 页 面 index. xhtml( 主 页 ) 以 及 相应 的 类 名 为 bean. Index 的 会 话 作 用 域 受 
管 bean。 页 面 的 运行 效果 如 图 6-7 所 示 。 


网 上 书店 一 图 书 搜索 - Wozilla Firefox 
文件 E) 编辑 EE) 查看 CD) 历史 G) 书签 @) 工具 CD) 帮助 几 


= | 回 http://localhost:8080/shB_lookandbuy/faces/index xhtml 


要 查看 已 先 购 的 图 书 ,请 单 击 购物 车 


按 书 名 ， [本 


[ss st 
操作 系统 原理 李 晓 丹 中 国人 民 大 学 出 版 社 36.00 选 购 
计时 机 编译 诛 进 李 丽 轩 清华 大 学 出 版 社 31.00 ”选中 


图 6-7 图 书 搜索 页 面 (主页 ) 


单 击 “ 搜 索 ” 按 钮 ,页 面 将 显示 所 有 书 名 包含 指定 搜索 串 的 图 书信 息 。 单 击 “ 全 部 ”按钮 ， 
页 面 显示 所 有 图 书信 息 。 

单 击 某 图 书 书 名 的 超 链接 ,应 用 将 导航 至 页 面 (bookdetail. xhtml) ,显示 该 图 书 的 详细 
信息 。 

单 击 “ 选 购 ” 按 钮 ,应 用 将 该 图 书 添加 至 sessionBeanl 中 的 cart 属性 : 如 果 购 物 车 中 已 
有 该 图 书 的 选 购 项 , 则 将 其 数量 加 1; 否 则 新 添加 一 个 选 购 项 ,并 将 其 数量 设置 为 1。 然后 重 
新 显示 本 页 面 。 

该 页 面 分 页 显示 图 书信 息 。 页 面 中 应 提供 相应 的 页 码 超 链接 以 实现 翻 页 功能 。 

单 击 “ 购 物 车 ” 超 链接 可 导航 至 购物 车 页 面 ,购物 车 页 面 在 名 为 cart” 的 新 窗口 或 标签 
页 中 打开 。 

(9) 创建 页 面 bookdetail. xhtml 以 及 相应 的 名 为 bean. Bookdetail 的 会 话 作 用 域 受 管 
bean。 页 面 的 运行 效果 如 图 6-8 所 示 。 

单 击 “ 添 加 至 购物 车 ”按钮 时 ,应 用 将 该 图 书 添加 至 sessionBeanl 中 的 cart 属性 : 如 果 
购物 车 中 已 有 该 图 书 的 选 购 项 , 则 将 其 数量 加 1; 和 否则 新 添加 一 个 选 购 项 ,并 将 其 数量 设置 
为 1。 然后 导航 至 购物 车 页 面 ,购物 车 页 面 在 名 为 “cart” 的 新 窗口 或 标签 页 中 打开 。 

SP 


网 上 书店 一 图 书 详细 信息 一 Wozilla Firefox 
编辑 E) 查看 WM) 历史 G) 书签 B) 工具 外 帮助 00 


文件 全 ) 


B http://1ocalhost:8080/shB_lookandbuy/faces/index. xhtnl 


计算 机 编译 原理 地 而 轩 
清华 大 学 出 版 社 国 加 

2212345123456 国有 

2008 年 9 月 第 1 版 2008 年 9 月 第 1 次 印刷 


图 6-8 图 书 详细 信息 页 面 


(10) 创建 页 面 cart. xhtml 以 及 相应 的 名 为 bean. Cart 的 会 话 作 用 域 受 管 bean。 页 面 
的 运行 效果 如 图 6-9 所 示 。 


网 上 书后 一 购物 车 - Wozilla Firefox 回回 加 
文件 人 E) 编辑 人 E) 查看 WV) 历史 (G) 书签 @) 工具 GO) 帮助 0 E23 


"| 


回 http://localhest:80801sh6_lookandbuy/ faces/cart. xhtml 


下 面 是 购物 车 内 容 。 要 以 会 员 身份 订购 图 书 ， 请 先 在 首页 登录 或 注册 。 


计算 机 系统 结构 张 小 勇 


中 国 统计 年 鉴 
计算 机 编译 原理 李 丽 轩 


图 6-9 购物 车 页 面 


单 击 “删除 ?按钮 ,可 以 从 购物 车 中 删除 相应 的 选 购 项 ; 单 击 “保存 "按钮 ,可 以 保存 用 户 
对 各 选 购 项 所 做 的 数量 修改 。 
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第 7 章 转换 器 与 验证 器 


本 章 主题 : 

。 标准 转换 器 

。 注册 转换 器 类 

。 引用 转换 器 

。 自 定义 转换 器 

。 标准 验证 器 

。 注册 验证 器 类 

。 引用 验证 器 

。 自 定义 验证 器 

在 JSF 应 用 中 ,来 自 客户 端的 请 求 参 数 被 作为 组 件 的 值 ,期 间 会 经 历 接 收 、 转 换 和 验证 
等 过 程 。 接 收发 生 于 请 求 处 理 生命 周期 的 “应 用 请 求 值 " 阶 段 , 指 每 个 组 件 读 取 属于 自己 的 
请 求 参 数 , 称 为 被 提交 值 。 转 换 和 验证 通常 发 生 于 请 求 处 理 生 命 周 期 的 “处 理 验 证 ”阶段 。 
对 于 每 个 组 件 ,首先 会 对 被 提交 值 进 行 转换 处 理 , 若 转换 成 功 , 则 继续 进行 验证 处 理 。 如 果 
转换 或 验证 出 错 , 可 以 抛 出 相应 的 例外 ,例外 中 通常 包含 一 个 FacesMessage 实例 作为 出 错 
信息 。 如 果 所 有 组 件 的 转换 和 验证 都 获得 通过 , 则 进入 “更 新 模型 值 ” 阶 段 ;否则 直接 进入 
“呈现 响应 ”阶段 ,转换 和 验证 过 程 中 产生 的 出 错 信息 会 呈现 在 响应 页 面 中 。 如 果 组 件 的 
immediate 属性 值 为 true, 那 么 其 转换 和 验证 处 理会 在 应 用 请 求 值 阶 段 立 即 进行 。 

本 章 介 绍 JSF 转换 模型 和 验证 模型 以 及 相关 的 编程 技术 。 


7.1 转换 器 概述 


转换 器 服务 于 组 件 ,用 于 完成 服务 器 端的 组 件 值 与 客户 端的 组 件 值 表示 之 间 的 转换 , 包 
括 输 入 转换 和 输出 转换 。 服 务 器 端的 组 件 值 可 以 是 各 种 Java 类 型 数据 (对 象 ) ,客户 端的 组 
件 值 表示 则 通常 是 字符 串 文 本 。 转 换 器 的 输入 转换 功能 是 将 一 定格 式 的 请 求 参数 (字符 串 
文本 ) 转 换 成 特定 类 型 的 Java 对 象 ,发 生 于 “处 理 验 证 "阶段 。 转 换 器 的 输出 转换 功能 是 将 
特定 类 型 的 Java 对 象 转换 成 一 定格 式 的 字符 串 文 本 以 供 显示 ,发 生 于 “呈现 响应 ”阶段 。 

对 于 各 种 转换 器 ,输入 转换 的 源 与 输出 转换 的 目标 都 是 字符 串 文 本 。 对 于 某 种 转换 器 ， 
输入 转换 的 目标 与 输出 转换 的 源 总 是 同一 种 Java 类 型 对 象 。 通 常 也 把 这 种 Java 数据 类 型 
称 作 是 该 种 转换 器 能 够 支持 转换 的 数据 类 型 。 

能 接受 转换 器 服务 的 组 件 应 该 是 实现 ValueHolder 接口 的 组 件 , 包 括 输入 类 组 件 、 输 出 
类 组 件 、 视 图 参数 组 件 、 结 果 类 组 件 等 。 

转换 器 模型 的 编程 主要 涉及 定义 转换 器 类 注册 转换 器 类 和 引用 转换 器 等 三 方面 的 
正 作 < 
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1. 定义 转换 器 类 

转换 器 类 是 实现 Converter 接口 的 类 ,主要 包括 两 个 实例 方法 ,分 别提 供 输入 转换 和 输 
出 转换 的 功能 。 

JSF 框架 本 身 提 供 一 组 所 谓 的 标准 转换 器 ,可 以 支持 一 些 常见 的 Java 数据 类 型 的 
转换 。 

2. 注册 转换 器 类 

一 般 来 说 ,要 使 用 转换 器 ,需要 先 向 JSF 应 用 注册 相应 的 转换 器 类 。 通 过 注册 转换 器 
类 ,JSF 框架 或 页 面 制作 者 可 以 更 好 地 为 组 件 引 用 所 需 的 转换 器 。 

JSF 框架 提供 的 各 标准 转换 器 类 在 JSF 应 用 启动 时 都 自动 进行 了 注册 。 

3. 引用 转换 器 

引用 转换 器 是 指 在 组 件 上 注册 指定 类 型 的 转换 器 对 象 ,以 便 为 该 组 件 提供 相应 的 转换 
服务 。 调 用 ValueHolder 型 组 件 的 setConverter 方法 可 以 为 该 组 件 注册 指定 的 转换 器 。 更 
多 情况 下 ,可 以 通过 声明 的 方式 为 组 件 注册 指定 类 型 的 转换 器 。 


7.2 使 用 标准 转换 器 


本 节 介 绍 JSF 框架 自 含 的 标准 转换 器 ,包括 标准 转换 器 的 种 类 ,注册 情况 、 引 用 方法 以 
及 标准 转换 错误 消息 等 。 


标准 转换 器 简介 

标准 转换 器 由 JSF 规范 定义 、 随 JSF 实现 一 起 提供 给 用 户 , 主 要 用 于 一 些 常 见 的 Java 
类 型 的 组 件 值 与 其 字符 串 文本 表示 之 间 的 转换 。 表 7-1 给 出 了 各 标准 转换 器 类 的 类 名 及 其 
支持 转换 的 Java 数据 类 型 ,其 中 标准 转换 器 类 都 属于 javax. faces. convert 包 , 其 支持 转换 
的 数据 类 型 无 特殊 指明 都 属于 java. lang 包 。 


表 7-1 标准 转换 器 及 其 支持 转换 的 数据 类 型 


72. 工 


标准 转换 器 类 支持 转换 的 数据 类 型 标准 转换 器 类 支持 转换 的 数据 类 型 
ByteConverter Byte BooleanConverter Boolean 
ShortConverter Short BigDecimalConverter java. math. BigDecimal 
IntegerConverter Integer BigIntegerConverter java. math. BigInteger 
LongConverter Long EnumConverter Enum( 枚 举 类 型 ) 
CharacterConverter Character DateTimeConverter java. util. Date 
FloatConverter Float NumberConverter Number 
DoubleConverter Double 


要 使 用 转换 器 ,通常 需 先 向 JSF 应 用 注册 相应 的 转换 器 类 。 转 换 器 类 可 按 ID( 标 识 符 ) 


注册 ,也 可 按 类 型 (该 转换 器 支持 转换 的 数据 类 型 ) 注 册 , 或 者 既 按 ID 注册 ,又 按 类 型 注册 。 

按 ID 注册 后 ,开发 人 员 就 可 以 在 页 面 文件 中 通过 ID 为 某 组 件 指定 其 所 需要 的 转换 器 。 按 

类 型 注册 后 , 当 某 组 件 需要 进行 这 种 类 型 的 转换 时 ,JSF 框架 会 自动 创建 对 应 类 型 的 转换 器 
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对 象 , 提 供 相 应 的 转换 服务 。 

当 JSF 应 用 启动 ,所 有 的 标准 转换 器 都 会 自动 完成 按 ID 注册 或 者 按 类 型 注册 ,如 表 7-2 
所 示 。 其 中 ,转换 器 EnumConverter 只 按 类 型 进行 了 注册 ,转换 器 DateTimeConverter 和 
转换 器 NumberConverter 都 只 按 ID 进行 了 注册 。 


表 7-2 标准 转换 器 的 注册 


标准 转换 器 类 注册 ID 是 否 按 类 型 注册 
ByteConverter javax. faces. Byte ~ 
ShortConverter javax. faces. Short 
IntegerConverter javax. faces. Integer Sh 
LongConverter javax. faces. Long Vv 
CharacterConverter javax. faces. Character ~ 
FloatConverter javax. faces. Float Nh 
DoubleConverter javax. faces. Double ~ 
BooleanConverter javax. faces. Boolean ~ 
BigDecimalConverter javax. faces. BigDecimal ~ 
BigIntegerConverter javax. faces. BigInteger ~ 
EnumConverter 无 ~V 
DateTimeConverter javax. faces. DateTime 否 
NumberConverter javax. faces. Number 否 


标准 转换 器 的 这 种 注册 应 该 被 看 做 是 一 种 默认 注册 。 开 发 人 员 可 以 用 相同 的 ID 或 类 
型 名 注册 自 定义 的 转换 器 类 ,这 样 就 会 覆盖 这 种 默认 注册 。 


7.2.2 引用 转换 器 


引用 转换 器 是 指 为 特定 组 件 指定 所 需 的 转换 器 ,以 便 为 组 件 值 的 转换 提供 服务 。 引 用 
转换 器 的 方式 有 多 种 ,下 面 分 别 介绍 。 

1. 默认 方式 

如 果 组 件 标 记 的 value 属性 与 受 管 bean 的 某 个 属性 关联 ,那么 JSF 框架 会 为 该 组 件 自 
动 创建 一 个 支持 该 bean 属性 类 型 转换 的 转换 器 对 象 。 此 种 方式 要 求 相 应 的 转换 器 类 已 按 
类 型 进行 了 注册 。 

例如 ,下 面 h:inputText 标记 的 value 属性 指向 myBean 受 管 bean 的 num 属性 : 


<h:inputText value="# {myBean.num}" /> 


如 果 num 属性 的 类 型 为 java. lang. Integer, 那 么 在 默认 情况 下 (还 没有 为 该 类 型 注册 
自 定义 的 转换 器 类 ),JSF 框架 会 为 该 标记 组 件 自 动 创建 java. faces. convert. 
IntegerConverter 型 转换 器 ,提供 从 字符 串 文本 到 Integer 型 数据 和 从 Integer 型 数据 到 字 
符 串 文本 的 转换 服务 。 


宝生 相让 


又 例如 ,下 面 h:outputText 标记 的 value 属性 指向 myBean 受 管 bean 的 sex 属性 : 
<h:outputText value="# {myBean.sex}" /> 


如 果 sex 属性 的 类 型 为 boolean(java. lang. Boolean) ,那么 在 默认 情况 下 ,JSF 框架 会 为 
该 标记 组 件 自动 创建 java. faces. convert. BooleanConverter 型 转换 器 ,提供 从 Boolean 型 数 
据 到 字符 串 文 本 的 转换 服务 。 

2. 通过 ID 引用 转换 器 

将 组 件 标记 的 converter 属性 或 f: converter 子 标 记 的 converterId 属性 设置 为 某 转换 
器 类 的 注册 ID, 此 时 ,JSF 框架 会 为 该 标记 组 件 创 建 指定 类 型 的 转换 器 对 象 。 此 种 方式 要 
求 转 换 器 类 已 按 ID 进行 了 注册 。 

下 面 是 使 用 该 种 方式 引用 转换 器 的 示例 。 


<h:inputText converter="javax.faces.Integer"/> 
或 : 


<h:inputText> 
<f:converter converterId="javax.faces.Integer"/> 
</h:inputText> 


这 里 ,javax. faces. Integer 是 javax. faces. convert. IntegerConverter 转换 器 类 的 注册 ID。 
JSF 框架 会 在 需要 时 为 组 件 自动 创建 该 种 类 型 的 转换 器 对 象 , 提 供 相应 的 转换 服务 。 

3, 直接 引用 转换 器 

让 组 件 标 记 的 f:converter 子 标 记 的 binding 属性 指向 某 受 管 bean 的 一 个 属性 ,而 该 属 
性 的 值 是 一 个 转换 器 对 象 。 此 种 方式 不 要 求 相 关 的 转换 器 类 已 经 注册 。 

下 面 是 使 用 该 种 方式 引用 转换 器 的 示例 ,其 中 f:converter 子 标记 的 binding 属性 通过 
值 表达 式 指 向 myBean 受 管 bean 的 cvt 属性 。 


<h:inputText> 
<f:converter binding="#{myBean.cvt}"/> 


</h:inputText> 


myBean 受 管 bean 的 cvt 属性 的 类 型 应 该 是 一 个 转换 器 类 ,并 能 返回 该 种 类 型 的 一 个 
转换 器 对 象 。 例 如 ,下 面 代码 定义 了 一 个 可 读 写 的 cvt 属性 ,可 返回 一 个 IntegerConverter 
型 转换 器 。 


IntegerConverter cvt=new IntegerConverter () 7 
Public IntegerConverter getCvt (){ 
return cvt; 
} 
public void setCvt (IntegerConverter cvt){ 
this.cvt=cvt; 
} 


上 面 介 绍 的 引用 转换 器 的 方法 不 仅 适用 于 标准 转换 器 ,也 适用 于 后 面 要 介绍 的 自 定义 
转换 器 。 对 标准 的 DateTimeConverter 转换 器 和 NumberConverter 转换 器 ,JSF 还 提供 用 
。 162。 


于 引用 转换 器 的 专用 标记 ,下 面 分 别 介绍 。 


7.2.3 DateTimeConverter 转换 器 


日 期 时 间 转 换 器 (DateTimeConverter) 是 一 种 标准 转换 器 。 默 认 情 况 下 ,这 种 转换 器 只 
按 ID 进行 了 注册 ,而 没有 按 类 型 进行 注册 。 

虽然 可 以 采用 上 述 方式 2 或 方式 3 引用 日 期 时 间 转 换 器 ,但 更 多 的 情况 下 会 采用 这 种 
转换 器 的 专用 标记 f:convertDateTime。 采 用 f:convertDateTime 标记 引用 日 期 时 间 转 换 
器 时 ,可 以 通过 设置 标记 的 属性 来 控制 转换 器 的 转换 行为 。 

下 面 介 绍 该 专用 标记 的 属性 及 其 用 法 。 

(1) type: 指定 日 期 时 间 字 符 串 包含 的 内 容 , 取 值 范围 date、time 和 both, 默 认 值 为 date。 

(2) dateStyle: 指定 日 期 部 分 的 样式 , 仅 在 设置 了 type 属性 值 为 “date” 或 “both” 时 有 
效 。 取 值 范围 包括 : 

。 short: 09-10-23、10/23/09。 

。 medium( 默 认 ) : 2009-10-23、Oct 23，2009 。 

。 long: 2009 年 10 月 23 日 .October 23，2009。 

。 full: 2009 年 10 月 23 日 星期 五 \Friday, October 23, 2009。 

说 明 : 上 面 每 一 个 取 值 都 有 两 个 不 同 的 示例 ,这 取决 于 locale 属性 的 设置 。 对 相同 的 
日 期 样式 ,如果 设置 了 不 同 的 场所 、 语 言 ,那么 会 有 不 同 的 表示 形式 。 

(3) timeStyle: 指定 时 间 部 分 的 样式 , 仅 在 设置 了 type 属性 值 为 “time” 和 “both” 时 有 
效 。 取 值 范围 包括 : 

。 short: 3:25 PM、 下 午 3:25。 

。 medium( 默 认 ): 3:25:50 PM、15 :25 :50。 

。 long: 3:25:50 PM CST. 下 午 03 时 25 分 50 秒 。 

。 full: 3:25:50 PM CST、 下 午 03 时 25 分 50 秒 CST。 

说 明 : 上 面 每 一 个 取 值 都 有 两 个 不 同 的 示例 ,这 取决 于 locale 属性 的 设置 。 对 相同 的 
时 间 样 式 , 如 果 设置 了 不 同 的 场所 \ 语 言 ,那么 会 有 不 同 的 表示 形式 。 

(4) locale: 指定 场所 。 一 个 Locale 对 象 或 表示 语言 代码 的 字符 串 , 如 en、zh。 一 般 来 
说 ,一 个 场所 的 语言 特性 会 影响 日 期 时 间 数 据 的 具体 表示 形式 。 默 认 情 况 下 ,该 属性 值 为 本 
地 场所 。 

(5) timeZone: 指定 时 区 。 一 个 表示 时 区 ID 的 字符 串 , 如 PRC、GMT 十 8。 实 际 上 ， 
Date 对 象 存放 的 是 格林 尼 治 时 间 ,所 以 在 默认 情况 下 ,该 转换 器 接收 或 产生 的 字符 串 文 本 
都 被 看 作 是 格林 尼 治 时 间 。 如 果 要 使 用 其 他 时 区 的 时 间 ,应 该 设置 该 属性 。 

(6) pattern: 直接 指定 日 期 时 间 的 字符 串 文本 表示 的 模式 。 指 定 该 属性 后 ,type、 
dateStyle ,timeStyle 都 将 失效 。 在 指定 模式 时 可 使 用 下 面 专用 字符 (区 分 大 小 写 ) : 

。M: 月 份 ,如 MM(08)、MMM( 八 月 )。 

。d: 日 期 ,如 dd(05)。 

。y: 年 份 ,如 yy(12)、yyyy(2012)。 

。 王 : 星期 几 , 如 EEE( 星 期 六 )。 

。 H: 小 时 (0-23)。 
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。 开 : 小 时 (0-11) 。 

。m: 分 ,如 mm(15 ) 。 

。s; 秒 ,ss(45) 。 

。 S: 毫秒 ,如 SSS(865) 。 

。 a: 上 、 下 午 标记 ,如 a( 下 午 )。 

下 面 标记 中 ,假设 createTime 属性 是 Date 型 的 。 引 用 转换 器 标记 指定 既 显示 日 期 也 
显示 时 间 , 时 区 为 北京 (GMT 十 8)。 


<h:outputText value="# {myBean.createTime}"> 
<f:convertDateTime type="both" timeZone="PRC"/> 


</h:outputText> 
如 果 本 地 场所 为 Locale. CHINA ,那么 上 面 标记 的 呈现 效果 类 似 如 下 : 
2012-6-27 13:22:01 


如 果 在 引用 转换 器 标记 中 添加 属性 设置 : timeStyle 二 "long" ,那么 标记 的 呈现 效果 类 
似 如 下 : 


2012-6-27 下 午 01 时 22 分 01 秒 


下 面 标记 中 ,假设 expirationDate 属性 是 Date 的 。 引 用 转换 器 标记 通过 pattern 属性 
指定 了 日 期 时 间 的 字符 串 文 本 表示 的 模式 。 


<h:inputText value="# {myBean.expirationDate}"> 
<f:convertDateTime pattern="MM/yyyy" timeZone="PRC"/> 
</h:inputText> 


呈现 时 ,文本 域 中 仅 显 示 expirationDate 属性 值 的 月 份 与 年 份 ,两 者 用 /分 隔 。 输 入 时 ， 
也 应 该 按 该 模式 输入 ,否则 转换 器 将 无 法 理解 而 出 错 或 出 现 错误 结果 。 由 于 仅 指 定 了 年 份 
和 月 份 , 输 入 结果 的 日 期 将 被 设置 为 1、 时 间 则 被 设置 为 0。 

在 论坛 应 用 中 ,主题 表 和 回复 表 中 都 包含 Date 型 数据 的 显示 ,如 主题 的 创建 时 间 、 最 后 
回复 时 间 等 。 为 了 能 按 所 需 的 格式 显示 这 些 时 间 , 应 用 专门 编写 了 一 个 实用 方法 getTime 
(Date) 。 若 一 个 页 面 要 显示 时 间 ,可 以 先 调用 该 方法 将 Date 型 数据 转换 成 一 定格 式 的 字符 
串 , 然 后 再 显示 。 例 如 ,主题 表 中 显示 创建 时 间 的 标记 : 


<h:outputText value="#{index.showTime (topic.createtime)}" styleClass="font3"/> 


其 中 , 受 管 bean 的 showTime 方法 会 调用 实用 方法 getTime(Date) 将 主题 的 创建 时 间 转 换 
成 一 定格 式 的 字符 串 。 

有 了 这 个 标准 的 日 期 时 间 转 换 器 后 ,就 不 需要 这 么 麻烦 了 。 可 以 直接 引用 该 转换 器 ,将 
一 个 Date 型 数据 转换 成 所 需 格式 的 字符 串 输出 。 例 如 ,主题 表 中 显示 创建 时 间 的 标记 可 以 
改写 成 如 下 : 


<h:outputText value="#{topic.createtime}" styleClass="font3"> 
<f:convertDateTime type="both" dateStyle="medium" timeStyle="short"/> 
</h:outputText> 
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7.2.4 NumberConverter 转换 器 


数值 转换 器 (NumberConverter) 是 一 种 标准 转换 器 。 默 认 情 况 下 ,这 种 转换 器 只 按 ID 
进行 了 注册 ,而 没有 按 类 型 进行 注册 。 

java. lang. Number 是 一 个 表示 数值 的 抽象 超 类 ,其 子 类 包括 : 

。 java. lang. Byte。 

。 java. lang. Short 。 

。 java. lang. Integer。 

。 java. lang. Long。 

。 java. lang.Float 。 

。 java. lang. Double。 

。 java. math. BigInteger。 

。 java. math. BigDecimal 。 

NumberConverter 转换 器 支持 上 述 各 种 类 型 的 组 件 值 与 字符 串 文本 之 间 的 转换 。 对 于 
与 组 件 值 绑 定 在 一 起 的 受 管 bean 属性 ,其 类 型 也 可 以 是 相应 的 基本 类 型 ,如 int、double 等 。 

与 日 期 时 间 转 换 器 一 样 ,数值 转换 器 也 有 其 专用 的 引用 标记 f:convertNumber。 采 用 
f;convertDateTime 标记 引用 日 期 时 间 转 换 器 时 ,可 以 通过 设置 标记 的 属性 来 控制 转换 器 的 
转换 行为 。 

下 面 是 该 专用 标记 的 一 些 属性 及 其 用 法 。 

(1) type: 指定 表示 数值 的 字符 串 文 本 的 类 型 , 取 值 范围 包括 : 

。 number( 默 认 值 ) : 普通 数值 形式 。 

。 currency: 货币 形式 。 

。 percent: 百分数 形式 。 

(2) minIntegerDigits: 指定 输出 产生 的 字符 串 文 本 中 整数 部 分 的 最 少 位 数 ,不 足 时 高 
位 以 0 填充。 对 输入 无 影响 。 

(3) maxIntegerDigits: 指定 输出 产生 的 字符 串 文 本 中 整数 部 分 的 最 多 位 数 ,超出 时 截 
去 高 位 。 对 输入 无 影响 。 

(4) minFractionDigits: 指定 输出 产生 的 字符 串 文本 中 小 数 部 分 的 最 少 位 数 ,不 足 时 低 
位 以 0 填充 。 对 输入 无 影响 。 

(5) maxFractionDigits: 指定 输出 产生 的 字符 串 文 本 中 小 数 部 分 的 最 多 位 数 , 超 出 时 低 
位 采用 RoundingMode. HALF_EVEN 模式 舍 入 。 对 输入 无 影响 。 

(6) integerOnly: 指定 在 输入 转换 时 是 否 只 解析 整数 部 分 ,默认 值 为 false。 对 输出 无 影响 。 

(7) locale: 指定 场所 ,一 个 Locale 对 象 或 表示 语言 代码 的 字符 串 。 一 般 来 说 ,如 果 没 
有 其 他 属性 的 特别 指定 ,货币 形式 输出 时 的 货币 符号 会 由 该 属性 指定 的 场所 的 国家 特性 决 
定 。 上 默认 情况 下 ,该 属性 值 为 本 地 场所 。 

(8) currencySymbol: 指定 货币 符号 , 仅 当 type 属性 为 “currency” 时 有 效 。 

(9) currencyCode: 指定 使 用 ISO 定义 的 货币 代码 ,如 CNY、HKD、USD 等 , 仅 当 type 
属性 为 “currency” 时 有 效 。 

(10) groupingUsed: 指定 是 否 使 用 分 组 符号 。 默 认 情 况 下 .使 用 分 组 符号 。 只 影响 输出 。 
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(11) pattern: 指定 数值 的 字符 串 文本 表示 的 模式 。 具 体 写 法 可 参考 DecimalFormat 
类 的 API 文 档 。 
假设 myBean 受 管 bean 中 定义 有 以 下 可 读 属 性 : 


private double value=-12586.346; 
Public double getValue(){ 
return value; 


} 


下 面 组 件 标记 用 于 输出 该 bean 属性 值 ,其 中 引用 数值 转换 器 标记 指定 采用 货币 形式 
输出 。 


<h:outputText value="#{my.value}"> 
<f:convertNumber type="currency"/> 


</h:outputText> 

如 果 本 地 场所 为 Locale. CHINA ,那么 上 面 标记 的 呈现 效果 应 该 为 : 
-¥12,586.35 

将 引用 数值 转换 器 标记 改 成 如 下 , 显 式 指 明 货币 代码 为 USD。 
<f:convertNumber type="currency" currencyCode="USD"/> 

那么 不 管 本 地 场所 为 何 值 , 上 面 组 件 标记 的 输出 都 应 该 是 : 

-USD12,586.35 

将 引用 数值 转换 器 的 标记 改 成 如 下 ,最 多 小 数位 数 和 最 少 小 数位 数 都 设置 为 4。 
<f:convertNumber maxFractionDigits="4" minFractionDigits="4"/> 
那么 上 面 组 件 标 记 的 呈现 效果 应 该 是 : 

-12,586.3460 

将 引用 数值 转换 器 的 标记 改 成 如 下 ,其 中 用 pattern 属性 指定 了 字符 串 文本 的 模式 。 
<f:convertNumber pattern="#,###.0000"/> 


模式 指定 整数 部 分 采用 分 组 符号 (,) ,每 3 位 为 一 组 ;小 数 部 分 为 4 位 。 这 种 情况 的 输 
出 效果 与 第 三 种 情况 是 一 样 的 , 即 : 


-12,586.3460 


7.2.5 转换 错误 


在 请 求 处 理 生 命 周 期 的 “处 理 验 证 ”阶段 , 当 一 个 组 件 的 输入 转换 处 理 抛 出 例外 时 ,通常 

会 产生 一 个 错误 消息 (FacesMessage 对 象 ) 放 入 消息 队列 ,之 后 其 他 组 件 的 转换 和 验证 处 理 

还 会 继续 进行 。 当 该 阶段 结束 时 ,如 果 之 前 曾 有 例外 抛 出 ,那么 就 会 跳 过 其 他 阶段 ,直接 进 

入“ 呈现 响应 ”阶段 。 呈 现 的 页 面 中 会 包含 那些 无 法 完成 转换 的 输入 值 ,用 户 可 以 重新 修改 

输入 。 另 外 ,页 面 文件 中 通常 应 包含 相应 的 h:message 或 h: messages 组 件 标记 ,以 便 把 转 
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换 过 程 中 产生 错误 消息 呈现 出 来 。 


在 “呈现 响应 ”阶段 ,如 果 一 个 组 件 的 输出 转换 处 理 抛 出 例外 ,JSF 框架 将 会 产 


面 作为 响应 。 


错误 页 


JSF 框架 提供 一 组 标准 转换 错误 消息 资源 ,每 个 消息 资源 包含 一 个 ID 和 一 个 默认 的 消 
息 文 本 ,如 表 7-3 所 示 。 标 准 转 换 器 在 转换 处 理 中 发 生 错 误 时 ,都 会 以 其 中 某 个 消息 资源 文 
本 为 模板 产生 错误 消息 ,消息 文本 中 的 参数 会 用 相应 的 具体 内 容 代替 。 


表 7-3 标准 转换 错误 消息 


消息 ID 


消息 文本 


javax.faces.converter.Integer- 
Converter .INTEGER 


{2}: "{0}" must be a number consisting of one or 
more digits. 


javax.faces.converter.Integer- 
Converter.INTEGER detail 
javax.faces.converter.Double- 
Converter .DOUBLE 
javax.faces.converter.Double- 
Converter.DOUBLE detail 

x javax .faces.converter.Boolean- 
Converter .BOOLEAN detail 

javax .faces.converter .BigDecimal- 
Converter .BIGINTEGER detail 


javax.faces.converter .BigDecimal- 
Converter .BIGDECIMAL detail 


javax.faces.converter.Number- 
Converter .NUMBER detail 
javax.faces.converter.Number- 
Converter .CURRENCY detail 
javax.faces.converter.Number- 
Converter .PERCENT detail 
javax.faces.converter.DateTime- 
Converter.DATE detail 
javax.faces.converter.DateTime- 
Converter.TIME detail 


{2}: "{0}" must be a number between -2147483648 
and 2147483647 .Example: {1} 

{2}: "{0}" must be a number consisting of one or 
more digits. 

{2}: "{0}" must be a number between 4.9E-324 and 
1.7976931348623157E308.Example: {1} 


{1}: "{0}" must be 'true' or 'false'. Any value 


other than 'true' will evaluate to 'false'. 
"“{0}" must be a number consisting of one or more 
digits. Example: {1} 

"“{0}" must be a signed decimal number consisting 
of zero or more digits, that may be followed by a 


decimal point and fraction. Example: {1} 
{2}: "{0}" is not a number. Example: {1} 


{2}: "{0}" could not be understood as a currency 
value. Example: {1} 

下 
percentage. Example: {1} 

{2}: "{0}" could not be understood as a date. 
Example: {1} 

{2}: 
Example: {1} 


could not be understood as a 


"{0}" could not be understood as a time. 


javax.faces.converter.DateTime- 
Converter.DATETIME detail 


{2}: "{0}" could not be understood as a date and 


time. Example: {1} 


javax.faces.converter.Enum 
Converter .ENUM 


{2}: "{0}" must be convertible to an enum. 


javax.faces.converter.Enum 
Converter .ENUM detail 


{2}: "{0}" must be convertible to an enum from 


the enum that contains the constant "{1}". 


* javax .faces .ConVerter.Enum- 
Converter .ENUM NO CLASS detail 


{1}: "{0}" must be convertible to an enum from 


the enum, but no enum class provided. 


¥x javax.faces.converter .STRING 


{1k 


Could not convert "{0}" to a string. 
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说 明 ， 

(1) 当 概 要 文本 是 详细 文本 的 子 串 时 ,只 列 出 详细 文本 ,其 中 斜体 部 分 是 概要 文本 不 具 
有 的 。 

(2) 对 大 多 数 消息 文本 ,{0} 为 转换 失败 的 提交 值 ,{1} 为 有 效 值 示 例 ,{2} 是 组 件 标 签 。 
对 消息 ID 前 打 * 的 消息 文本 ,{0)} 为 转换 失败 的 提交 值 ,{1} 是 组 件 标签 。 

(3) 表 中 最 后 一 个 消息 文本 是 各 标准 转换 器 在 输出 转换 出 错时 要 用 到 的 ,其 他 各 消息 
文本 都 是 某 标准 转换 器 在 输入 转换 出 错时 要 用 到 的 。 

如 果 对 组 件 的 converterMessage 属性 进行 了 设置 ,那么 该 属性 值 将 代替 由 相关 转换 器 
或 独立 转换 方法 产生 的 错误 消息 显示 于 响应 页 面 。 

也 可 以 通过 自 定义 消息 包 来 覆盖 上 述 标准 转换 错误 消息 文本 , 即 让 标准 转换 器 基于 开 
发 人 员 指 定 的 消息 文本 产生 转换 错误 消息 。 该 技术 将 在 第 9. 2 节 详 细 介 绍 。 


7.3 自 定 义 转换 器 


标准 转换 器 能 满足 大 多 数 一 般 性 的 转换 需求 ,但 一 些 特殊 的 转换 任务 还 需要 自 定义 转 
换 器 来 完成 。 本 节 介绍 自 定义 转换 器 类 的 编写 及 注册 。 


7.3.1 编写 自 定义 转换 器 类 


转换 器 类 必须 实现 转换 器 接口 , 即 javax. faces. convert. Converter 接口 。Converter 接 
口 声 明了 输入 转换 方法 getAsObject 和 输出 转换 方法 getAsString ,分 别 对 应 转换 器 的 两 种 
功能 。 

输入 转换 方法 用 于 将 指定 的 字符 串 文 本 转换 成 特定 类 型 的 数据 ,下 面 是 其 方法 签名 。 


Object getAsObject (FacesContext context，UIComponent component, String value) 


throws ConverterException 


方法 包含 三 个 参数 , 当 JSF 框架 要 调用 该 方法 对 一 个 组 件 值 进行 输入 转换 时 ,会 自动 
传人 这 些 参 数 。 

。 context: 当前 请 求 上 下 文 ,保存 了 与 当前 请 求 处 理 相关 的 所 有 信息 。 

。 component: 正 被 转换 的 UI 组 件 。 

。 value: 要 被 转换 的 字符 串 文本 。 

如 果 转 换 失 败 , 方 法 可 以 抛 出 一 个 不 受 检查 的 运行 时 ConverterException 例外 。 该 例 
外 在 创建 时 通常 应 携带 一 个 FacesMessage 消息 ,JSF 框架 在 处 理 例 外 时 ,会 将 该 消息 压 入 
消息 队列 。 当 所 在 阶段 结束 时 ,控制 将 直接 进入 呈现 响应 阶段 ,相应 的 消息 可 以 被 显示 在 页 
面 上 。 

输出 转换 方法 用 于 将 指定 的 特定 类 型 数据 转换 成 字符 串 文 本 ,下 面 是 其 方法 签名 。 


String getAsString (FacesContext context, UIComponent component, Object value) 


throws ConverterException 
方法 包含 三 个 参数 , 当 JSF 框架 要 调用 该 方法 对 一 个 组 件 值 进 行 输出 转换 时 ,会 自动 


传人 这 些 参 数 。 
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。 context: 当前 请 求 上 下 文 , 保 存 了 与 当前 请 求 处 理 相关 的 所 有 信息 。 

。 component: 正 被 转换 的 UI 组 件 。 

。 value: 要 被 转换 的 组 件 值 。 

输出 转换 方法 通常 不 应 出 现 错误 ,但 一 旦 出 现 转换 错误 ,方法 也 可 以 抛 出 一 个 不 受 检 查 
的 运行 时 ConverterException 例外 。 此 时 .JSF 框架 将 呈现 一 个 错误 页 面 。 


7.3.2 注册 自 定义 转换 器 类 


转换 器 在 使 用 之 前 通常 应 先 注册 其 转换 器 类 。 和 转换 器 类 可 按 ID 注册 ,也 可 按 类 型 注 
册 ,或 者 既 按 ID 注册 又 按 类 型 注册 。 

前 面 已 经 介绍 ,标准 转换 器 类 在 JSF 应 用 启动 时 会 自动 完成 相应 的 注册 ,但 自 定义 转 
换 器 类 则 需要 开发 人 员 自 行 注册 。 注 册 转 换 器 类 的 方法 有 两 种 : 一 是 在 Faces 配置 文件 中 
用 converter 元 素 进行 声明 ;二 是 用 @FacesConverter 型 标注 修饰 转换 器 类 。 

下 面 是 在 Faces 配置 文件 中 按 类 型 注册 转换 器 类 的 一 个 示例 。 


<faces-config 。..... > 
<converter> 
<converter-for-class>java.lang.Integer</converter-for-class> 
<converter-class>converter.MyIntegerConverter</converter-class> 
</converter> 


</faces-config> 


其 中 ,converter-for-class 子 元 素 指定 该 种 转换 器 所 支持 的 转换 类 型 ,converter-class 子 元 素 
指定 该 转换 器 类 的 完整 类 名 。 
下 面 是 采用 Java 标注 方式 按 类 型 注册 转换 器 类 的 一 个 示例 。 


Q@FacesConverter (forClass=java.lang.Integer.class) 


public class MyInteger implements Converter {...} 


其 中 ,@FacesConverter 标注 的 forClass 属性 指定 该 转换 器 支持 转换 的 数据 类 型 。 
下 面 是 在 Faces 配置 文件 中 按 ID 注册 转换 器 类 的 一 个 示例 。 


<faces-config ....... 
<converter> 
<converter-id>myconverter</converter-id> 
<converter-class>converter.MyIntegerConverter</converter-class> 
</converter> 


</faces-config> 
其 中 ,converter-id 子 元 素 指定 注册 的 转换 器 类 的 注册 ID。 

下 面 是 采用 Java 标注 方式 按 ID 注册 转换 器 类 的 一 个 示例 。 此 时 只 需要 在 标注 中 直接 
指定 转换 器 类 的 注册 ID。 


@FacesConverter ("myconverter") 
Public class MyInteger implements Converter {...} 


需要 时 ,可 以 用 自 定义 转换 器 蔡 换 标准 转换 器 。 例 如 在 完成 上 述 自 定义 转换 器 类 的 注 
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册 后 ,如 果 采 用 默认 方式 引用 转换 器 ,那么 JSF 框架 会 使 用 自 定 义 转换 器 完成 Integer 型 与 
字符 串 文本 之 间 的 转换 ;如 果 通 过 指定 注册 ID 方式 引用 转换 器 ,那么 当 指定 注册 ID 为 
myconverter 时 ,将 使 用 自 定义 转换 器 完成 Integer 型 与 字符 串 文本 之 间 的 转换 , 当 指定 注 
册 ID 为 javax. faces. Integer 时 ,将 使 用 标准 转换 器 完成 相应 的 转换 。 


7.3.3 自 定义 转换 器 应 用 示例 


该 应 用 项 目 (ch7_demo) 主 要 由 两 个 页 面 、 一 个 受 管 bean 和 一 个 自 定义 转换 器 类 组 成 。 
项 目的 运行 效果 如 图 7-1 所 示 。 


o — ozrilla Firefox 回回 因 | 
查看 WW) 历史 (5) 书 答 @) 工具 GO) 帮助 


[lp] 


ConverterDemo 一 


Hozilla Firefox 同 回 加 | 
查看 ) 历史 G) 书签 @) 工具 C 帮助 


=| 回 http://1ocalhost:8080/chT_demoy faces/index 


:|978-7-3a2-25839-1 Ce] 
ISBN 中 出 现 非法 字符 :a 


图 7-1 应 用 ch7_demo 运行 效果 图 


该 应 用 的 主要 功能 是 利用 一 个 自 定义 转换 器 对 用 户 输入 的 ISBN 图 书 编号 进行 格式 转 
换 。ISBN 编号 由 一 串 数字 组 成 ,这 串 数字 可 分 为 几 组 ,每 组 之 间 可 以 不 做 分 隔 , 也 可 以 用 
空格 或 减 号 (一 ) 分 隔 。 应 用 允许 用 户 采用 任何 一 种 格式 输入 ,但 经 转换 器 处 理 将 产生 统一 
的 不 含 分 隔 符 、 完 全 由 数字 组 成 的 ISBN 编号 。 

如 果 用 户 输入 的 ISBN 编号 成 功 通过 转换 ,应 用 将 导航 至 另 一 个 页 面 显 示 该 ISBN 编 
号 ;否则 呈现 原来 的 页 面 ,并 显示 转换 错误 消息 。 

1. 自 定义 转换 器 

自 定义 转换 器 类 ISBNConverter 定义 于 converter 包 , 见 代码 清单 7-1。 输 入 转换 的 主 
要 功能 是 去 除 输 入 的 ISBN 编号 中 空白 符号 (包括 空格 ) 和 减 号 (一 ) 返回 完全 由 数字 组 成 
ISBN 编号 。 如 果 输入 的 ISBN 编号 中 包含 其 他 字符 , 则 产生 转换 出 错 消息 .并 抛 出 例外 。 
输出 转换 只 是 返回 ISBN 编号 本 身 , 没 有 做 额外 的 处 理 。 

T= 


代码 清单 7-1 自 定义 转换 器 类 (converter. ISBNConerter. java) 


1. Package converter; 
2. import javax.faces .application.FacesMessage; 
3. import javax.faces .component .UIComponent; 
4. import javax.faces.context.FacesContext; 
5. import javax.faces.convert.Converter; 
6. import javax.faces.convert.ConverterException; 
Fs 
8. public class ISBNConverter implements Converter{ 
9s 
10. public Object getAsObject (FacesContext context,UIComponent component,String value) 
Ee throws ConverterException { 
Ep StringBuilder sb=new StringBuilder (value); 
135 int i=0; 
1 while(i<sb.length()){ 
天 char ch=sb.charAt (i); 
Ys if(Character.isDigit (ch)){ 
7, 和 
18. } else if(Character.isWhitespace (ch) ||ch= 
19» sb.deleteCharRt (i); 
28， } else { 
2 String s="ISBN 中 出 现 非法 字符 :"+ch; 
2 FacesMessage msg=new FacesMessage (s,s); 
23。 throw new ConverterException (msg); 
24. 
25。 ¥ 
26. return sb.tostring(); 
275， } 
28 。 
29. public String getAsString (FacesContext context,UIComponent component,Object value){ 
30 . return String.valueOf (value) 
3 } 
325 0 


该 自 定义 转换 器 类 按 ID 进行 注册 ,在 Faces 配置 文件 (faces-config. xml) 中 进行 声明 ， 
见 代码 清单 7-2。 
代码 清单 7-2 ”注册 自 定义 转换 器 类 (converter. ISBNConverter) 


.<?xml version='1.0' encoding='"'UTF- 8'?> 


. <faces-config version="2.0" ......; x 

<converter> 
<converter-id>isbnconverter</converter-id> 
<converter-class>converter.ISBNConverter</converter-class> 


</converter> 


oaouw wm PP 


.</faces-config> 


a 2 


2. 受 管 bean 

应 用 的 受 管 bean 是 请 求 作 用 域 的 ,其 中 定义 了 一 个 可 读 写 的 isbn 属性 ,具体 代码 如 代 
码 清单 7-3 所 示 。 

代码 清单 7-3” 受 管 bean(MyBean. java) 


. Package bean; 
. import javax.faces .bean.ManagedBean; 


. import javax.faces .bean.RequestScoped; 


权 

2 

3 

4 

5. @ManagedBean 
6. @RequestScoped 

7. public class MyBean { 
8 

9. private String isbn; 


10. public String getIsbn(){ 


11。 return isbn; 

2 } 

13. public void setIsbn(String isbn){ 
14. this.isbn=isbn; 

15s } 

165.3 

3. JSF 页 面 


该 应 用 包含 两 个 页 面 。index. xhtml( 代 码 清单 7-4) 是 一 个 欢迎 页 面 ,提供 一 个 表单 , 允 
许 用 户 输入 一 个 ISBN 编号 。 输 入 的 ISBN 编号 经 自 定义 转换 器 转换 后 保存 在 受 管 bean 的 
isbn 属性 中 。 

代码 清单 7-4 index. xhtml 


. <?xml version='1.0' encoding= 'UTE-8' ?> 

.<“!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1l/DTD/xhtmll-transitional.dtd"> 

.<html xmlns="http://www.w3.0rg/1999/xhtml" 


. 
2 
3 
4 
§s xmlns:h="http://java.sun.com/jsf/html" 
6 xmlns:f="http://java.sun.com/jsf/core"> 
学 <h:head> 

8 <title>ConverterDemo</title> 

9. </h:head> 


10. <h:body> 


EL <h:form> 

2 <h:outputLabel for="isbn" valu ISBN:"/> 

Er <h:inputText id="isbn" value="#{myBean.isbn}"> 
14. <f:converter converterId="isbnconverter"/> 
53 </h:inputText> 

16。 <h :commandButton value="OK" action="response"/> 
了 了 <p/> 


18 . <h:message for="isbn"/> 
19。 </h:form> 

20. </h:body> 

21. </htmi> 


response. xhtml( 代 码 清 单 7-5) 是 一 个 响应 页 面 ,只 是 简单 地 将 保存 在 受 管 bean 中 的 
isbn 属性 值 读 出 显示 。 
代码 清单 7-5 response. xhtml 
1. <?xml version='1.0' encoding= 'UTE-8' ?> 


2. <!DOCTYPE html PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 
3. "http://www.w3.o0rg/TR/xhtml1l/DTD/xhtmll-transitional.dtd"> 


4. <html xmlns="http://www.w3.0rg/1999/xhtml" 

和 xmlns:h="http://java.sun.com/jsf/html"> 

6. <h:head> 

了 <title>ConverterDemo</title> 

8 </h:head> 

9 <h:body> 
0s <h:outputLabel for="isbn" value="ISBN:"/> 
Ls <h:outputText id="isbn" value="#{myBean.isbn}"/> 
12. </h:body> 
13. </html> 


7.4 验证 器 概述 


验证 器 服务 于 组 件 , 用 于 对 已 经 经 过 输入 转换 的 组 件 的 被 提交 值 进行 有 效 性 验证 ,如 数 
值 型 的 组 件 值 是 否 在 指定 的 范围 内 、String 型 的 组 件 值 的 长 度 是 否 小 于 约定 的 值 等 。 验 证 
服务 发 生 于 请 求 处 理 生 命 周期 的 "处理 验证 ?阶段 。 在 该 阶段 , 先 对 组 件 的 被 提交 值 进行 输 
入 转换 ,如 果 转 换 成 功 , 则 接着 进行 验证 处 理 。 如 果 验 证 成 功 , 则 产生 组 件 的 本 地 值 , 若 该 值 
不 同 于 组 件 原来 的 值 , 则 引发 组 件 的 值 变 化 事件 ,并 被 压 人 事件 队列 。 

能 接受 验证 器 服务 的 组 件 应 该 是 实现 EditableValueHolder 接口 的 组 件 , 包 括 输 入 类 组 
件 、 视 图 参数 组 件 等 。 

验证 器 模型 的 编程 主要 涉及 定义 验证 器 类 、 注 册 验 证 器 类 和 引用 验证 器 等 三 方面 的 
工作 3 

1. 定义 验证 器 类 

验证 器 类 是 实现 Validator 接口 的 类 ,主要 包含 一 个 实例 方法 ,提供 对 某 组 件 值 的 特定 
的 验证 处 理 功 能 。 

JSF 框架 本 身 提供 一 组 所 谓 的 标准 验证 器 ,可 以 完成 一 些 基 本 的 组 件 值 验证 处 理 功 能 。 

2. 注册 验证 器 类 

一 般 来 说 ,要 使 用 验证 器 ,需要 先 向 JSF 应 用 注册 相应 的 验证 器 类 。 通 过 注册 验证 器 
类 ,页 面 制作 者 可 以 更 好 地 为 组 件 引用 所 需 的 验证 器 。 

JSF 框架 提供 的 各 标准 验证 器 类 在 JSF 应 用 启动 时 都 自动 进行 了 注册 。 


到 和 3 二 


3. 引用 验证 器 

引用 验证 器 是 指 在 组 件 上 注册 指定 类 型 的 验证 器 对 象 ,以 便 为 该 组 件 值 提 供 相 应 的 验 
证 服务 。 调 用 EditableValueHolder 型 组 件 的 setValidator 方法 可 以 为 该 组 件 注册 指定 的 
验证 器 。 更 多 情况 下 ,可 以 通过 声明 的 方式 为 组 件 注册 指定 类 型 的 验证 器 。 

一 个 组 件 可 以 注册 多 个 验证 器 对 象 ,这 些 验证 器 的 验证 功能 会 被 依次 调用 。 


7.5 使 用 标准 验证 器 


本 节 介 绍 JSF 框架 自 含 的 标准 验证 器 ,包括 标准 转换 器 的 种 类 ,注册 情况 .引用 方法 以 
及 标准 验证 错误 消息 等 。 


7.5.1 标准 验证 器 简介 


标准 验证 器 由 JSF 规范 定义 、 随 JSF 实现 一 起 提供 给 用 户 , 主 要 用 于 完成 一 些 基 本 的 
组 件 值 验证 处 理 功能 。 表 7-4 给 出 了 几 个 主要 的 标准 验证 器 类 的 类 名 及 其 功能 说 明 , 其 中 
标准 验证 器 类 都 属于 javax. faces. validator 包 。 


表 7-4 标准 验证 器 


验证 器 类 名 功能 说 明 
检测 数值 型 的 组 件 值 是 否 在 指定 的 范围 内 
检测 String 型 的 组 件 值 长 度 是 否 在 指定 范围 内 

检测 整 型 组 件 值 是 否 在 指定 范围 内 

检测 组 件 值 是 否 匹配 指定 的 正则 表达 式 

强制 组 件 值 不 能 为 空 。 相 当 于 将 组 件 标记 的 required 属性 设置 为 true 


DoubleRangeValidator 


LengthValidator 
LongRangeValidator 
RegexValidator 
RequiredValidator 


各 标准 验证 器 类 在 JSF 应 用 启动 时 都 自动 进行 了 注册 。 与 转换 器 类 不 同 , 验 证 器 类 只 
按 ID( 标 识 符 ) 进 行 注册 。 注 册 了 验证 器 类 ,页 面 制作 者 就 可 以 通过 指定 注册 ID 来 引用 指 
定 类 型 的 验证 器 。 对 标准 验证 器 ,更 一 般 的 引用 方式 是 使 用 其 专用 的 JSF 标记 。 表 7-5 列 
出 了 各 标准 验证 器 类 的 注册 ID 以 及 引用 该 验证 器 的 专用 JSF 标记 。 
表 7-5 标准 验证 器 的 注册 ID 与 引用 标记 
验证 器 类 注册 ID 引用 标记 


DoubleRangeValidator javax. faces. DoubleRange f:validateDoubleRange 


LengthValidator javax. faces. Length f:validateLength 


LongRangeValidator javax. faces. LongRange f:validateLongRange 


RegexValidator javax. faces. RegularExpression f:validateRegex 


RequiredValidator javax. faces. Required f:validateRequired 


这 里 ,前 三 个 标准 验证 器 的 引用 标记 都 包含 minimum 和 maximun 属性 ,用 以 指定 允许 
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值 的 下 限 和 上 限 ;RegexValidator 验证 器 的 引用 标记 包含 pattern 属性 ,用 以 指定 一 个 正则 
表达 式 。 


7.5.2 引用 验证 器 


引用 验证 器 是 指 为 特定 组 件 指定 所 需 的 验证 器 ,以 便 为 组 件 提供 值 验证 服务 。 引 用 验 
证 器 的 方式 有 多 种 ,下 面 分 别 介绍 。 

1. 通过 ID 引用 验证 器 

将 组 件 标 记 的 f:validator 子 标记 的 validatorId 属性 设置 为 某 验 证 器 类 的 注册 ID, 此 
时 ,JSF 框架 会 为 该 组 件 创 建 指定 类 型 的 验证 器 对 象 。 此 种 方式 要 求 验 证 器 类 已 按 ID 进行 
了 注册 。 下 面 是 使 用 该 种 方式 引用 验证 器 的 示例 。 


<h:inputText> 
<f:validator validatorId=" javax.faces.Required"/> 


</h:inputText> 


2. 引用 独立 的 验证 方法 
可 以 通过 组 件 标 记 的 validator 属性 注册 一 个 独立 的 验证 方法 。 下 面 代码 演示 了 这 种 
方法 的 使 用 。 


<h:inputText value="# {myBean.value}" validator="#{myBean.validate}/> 


这 里 ,validator 属性 指定 一 个 方法 表达 式 ,其 所 指 的 方法 称 为 独立 的 验证 方法 。 当 组 件 的 被 
提交 值 通过 转换 处 理 、 需 要 进一步 验证 时 ,JSF 框架 将 调用 该 独立 的 验证 方法 ,对 组 件 值 进 
行 验证 处 理 。 独 立 的 验证 方法 的 方法 签名 必须 如 下 : 


public void < 方法 名 > (FacesContext context,UIComponent component,Object value) 


方法 可 以 抛 出 一 个 不 受 检查 的 运行 时 ValidatorException 例外 。 

说 明 : 事实 上 ,JSF 框架 在 处 理 EditableValueHolder 型 组 件 标记 的 validator 属性 时 ， 
会 自动 创建 一 个 类 型 为 javax. faces. validator. MethodExpressionActionListener 的 验证 器 ， 
并 注册 在 组 件 上 。 该 验证 器 的 validate 方法 将 调用 validator 属性 指定 的 方法 。 

3. 直接 引用 验证 器 

让 组 件 标记 的 f:validator 子 标记 的 binding 属性 指向 某 受 管 bean 的 一 个 属性 ,而 该 属 
性 的 值 是 一 个 验证 器 对 象 。 此 种 方式 不 要 求 相关 的 验证 器 类 已 经 注册 。 

下 面 是 使 用 该 种 方式 引用 验证 器 的 示例 ,其 中 f: validator 子 标记 的 binding 属性 通过 
值 表达 式 指 向 myBean 受 管 bean 的 vdt 属性 。 


<h:inputText> 
<f:validator binding="#{myBean.vdt}"/> 
</h:inputText> 
myBean 受 管 bean 的 vdt 属性 的 类 型 应 该 是 一 个 验证 器 类 ,并 能 返回 该 种 类 型 的 一 个 
验证 器 对 象 。 
4. 使 用 专用 标记 引用 标准 验证 器 
各 标准 验证 器 都 有 相应 的 专用 引用 标记 。 使 用 专用 引用 标记 ,可 以 通过 其 相关 属性 设 
和 


置 所 需 的 验证 参数 ,下 面 举例 说 明 。 
下 面 标记 同样 要 求 输入 值 不 为 空 。 
<h:inputText> 


<f:validateRequired/> 


</h:inputText> 
下 面 标记 要 求 组 件 值 必须 是 整 型 . 且 其 值 在 0 至 100 之 间 。 


<h:inputText> 
<f:validateLongRange minimum="0" maximum="100"/> 


</h:inputText> 
下 面 标记 要 求 输入 的 组 件 值 (String 型 ) 的 长 度 应 大 于 等 于 6、 小 于 等 于 15。 


<h:inputText> 
<f:validateLength minimum="6" maximum="15"/> 


</h:inputText> 
下 面 标记 要 求 组 件 的 输入 值 只 能 是 “ 男 " 或 “ 女 ”。 


<h:inputText> 
<f:validateRegex pattern="[ 男 女 ]"/> 
</h:inputText> 


上 面 介绍 的 引用 验证 器 的 方式 中 ,方式 2 适用 于 自 定义 的 独立 验证 方法 ,方式 4 是 标准 
验证 器 专用 的 。 其 他 两 种 方式 既 适 用 于 标准 验证 器 ,也 适用 于 后 面 要 介绍 的 自 定义 验证 器 。 


7.5.3 验证 错误 


在 请 求 处 理 生 命 周期 的 “处 理 验证 ?阶段 , 当 一 个 组 件 的 验证 处 理 抛 出 例外 时 ,通常 会 产 
生 一 个 错误 消息 (FacesMessage 对 象 ) 放 和 人 消息 队列 ,之 后 其 他 的 验证 器 .其 他 组 件 的 转换 
和 验证 处 理 还 会 继续 进行 。 当 该 阶段 结束 时 ,如 果 之 前 曾 有 例外 抛 出 ,那么 就 会 跳 过 其 他 阶 
段 , 直 接 进入 呈现 响应 阶段 。 呈 现 的 页 面 中 会 包含 那些 验证 出 错 的 输入 值 , 用 户 可 以 重新 修 
改 输入 。 另 外 ,页 面 文件 中 通常 应 包含 相应 的 h: message 或 h:messages 组 件 标 记 , 以 便 把 
验证 过 程 中 产生 错误 消息 呈现 出 来 。 

JSF 框架 提供 一 组 标准 验证 错误 消息 资源 ,每 个 消息 资源 包含 一 个 ID 和 一 个 默认 的 消 
息 文本 ,如 表 7-6 所 示 。 标 准 验证 器 在 验证 处 理 中 发 生 错误 时 ,都 会 以 其 中 某 个 消息 资源 文 
本 为 模板 产生 错误 消息 ,消息 文本 中 的 参数 会 用 相应 的 具体 内 容 代 蔡 。 


表 7-6 标准 验证 错误 消息 


消息 ID 消息 文本 说 明 
javax.faces.component.UIInput. | {0}: Validation Error: Value 四 
- | {0) 为 组 件 标签 
REQUIRED is required 


{1}: Validation Error: Value | (1) 为 组 件 标签 , {0} 
is greater than allowable | 为 最 大 值 。 仅 指定 了 
maximum of "{0}" 最 大 值 时 使 用 


javax.faces.validator.DoubleRanger 
Validator .MAXIMUM 


-6a 


消息 ID 


消息 文本 


续 表 
说 明 


javax.faces.validator .DoubleRange” 
Validator .MINIMUM 


{1}: Validation Error: Value 


is less than allowable minimum 
of "{0}" 


位 } 为 组 件 标 签 , {0} 
为 最 小 值 。 仅 指定 了 
最 小 值 时 使 用 


Jjavax.faces.validator.DoubleRanger 
Validator.NOT IN RANGE 


{2}: Validation Error: Specified 
attribute is not between the 
expected values of {0} and {1}. 


{2) 为 组 件 标 签 , {0} 
为 最 小 值 , (1) 为 最 
大 值 


javax .faces.validator .DoubleRange- 
Validator.TYPE 


{0}: 
is not of the correct type 


Validation Error: Value 


{0} 为 组 件 标签 。 不 
能 转换 为 Double 型 
时 使 用 


javax.faces.validator .LongRange- 
Validator .MAXIMUM 


javax.faces.validator .LongRange- 
Validator .MINIMUM 


javax .faces.validator .LongRange- 
Validator.NOT IN RANGE 


javax.faces.validator .LongRange- 
Validator.TYPE 


javax.faces.validator.Length- 
Validator .MAXIMUM 


javax.faces.validator.Length- 
Validator .MINIMUM 


{1}: Validation Error: Value 
is greater than allowable 
maximum of "{0}" 


{1}: Validation Error Value is 
less than allowable minimum of 
"{0}" 


{2}: Validation Error: Specified 
attribute is not between the 
expected values of {0} and {1}. 


{0}: 
is not of the correct type 


Validation Error: Value 


{1}: Validation Error: Value 
is greater than allowable 
maximum of "{0}" 

{1}: Validation Error: Value 


is less than allowable minimum 
of "{0}" 


位 } 为 组 件 标签 , {0} 
为 最 大 值 。 仅 指定 了 
最 大 值 时 使 用 


人 1} 为 组 件 标签 , {0} 
为 最 小 值 。 仅 指定 了 
最 小 值 时 使 用 

{2} 为 组 件 标签 , {0} 
为 最 小 值 , {1) 为 最 
大 值 

{0} 为 组 件 标签 。 不 
能 转换 为 Long 型 时 
使 用 


位 } 为 组 件 标签 ,{0} 
为 最 大 长 度 


位 } 为 组 件 标签 ,{0} 
为 最 小 长 度 


与 标准 转换 错误 消息 不 同 ,各 标准 验证 错误 消息 的 概要 文本 和 详细 文本 都 是 相同 的 。 
如 果 对 组 件 的 requiredMessage、validatorMessage 属性 进行 了 设置 ,那么 这 些 属性 的 值 


将 代替 由 相关 验证 器 或 独立 验证 方法 产生 的 错误 消息 显示 于 响应 页 面 。 


也 可 以 通过 自 定 义 消息 包 来 覆盖 上 述 标准 验证 错误 消息 文本 , 即 让 标准 验证 器 基于 开 
发 人 员 指 定 的 消息 文本 产生 验证 错误 消息 。 该 技术 将 在 第 9 章 详细 介绍 。 


7.6 自 定 义 验 证 器 


标准 验证 器 能 满足 一 些 基 本 的 验证 需求 ,但 很 多 与 应 用 相关 的 验证 任务 还 需要 自 定义 
验证 器 来 完成 。 本 节 介 绍 自 定义 验证 器 类 的 编写 及 注册 。 


7.6.1 编写 自 定义 验证 器 类 


验证 器 类 必须 实现 验证 器 接口 , 即 javax. faces. validator. Validator 接口 。Validator 接 
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口 仅 声明 了 一 个 所 谓 验 证 方法 ,用 于 检验 组 件 值 的 正确 性 。 下 面 是 其 方法 签名 与 说 明 。 


public void validate (FacesContext context, UIComponent component, Object value) 


throws ValidatorException 


方法 包含 三 个 参数 , 当 JSF 框架 要 调用 该 方法 对 一 个 组 件 值 进行 验证 时 ,会 自动 传人 
这 些 参数 。 

。 context: 当前 请 求 上 下 文 , 保 存 了 与 当前 请 求 处 理 相关 的 所 有 信息 。 

。 component: 正 被 验证 的 UI 组 件 。 

。 value: 要 被 验证 的 组 件 值 。 

如 果 验 证 失败 ,方法 可 以 抛 出 一 个 不 受 检查 的 运行 时 ValidatorException 例外 。 该 例 
外 在 创建 时 通常 应 包含 一 个 FacesMessage 消息 ,JSF 框架 在 处 理 例 外 时 ,会 将 该 消息 压 和 人 
消息 队列 。 当 所 在 阶段 结束 时 ,控制 将 直接 进入 “呈现 响应 ”阶段 ,相应 的 消息 可 以 被 显示 在 
页 面 上 。 


7.6.2 注册 自 定义 验证 器 类 


引用 验证 器 之 前 通常 应 先 注册 相应 的 验证 器 类 。 验 证 器 类 按 ID 注册 。 前 面 已 经 介绍 ， 
标准 验证 器 类 在 JSF 应 用 启动 时 会 自动 完成 注册 .但 自 定义 验证 器 类 则 需要 开发 人 员 自行 
注册 。 注 册 验 证 器 类 的 方法 有 两 种 : 一 是 在 Faces 配置 文件 中 用 validator 元 素 进行 声明 ， 
validator 是 faces-config 元 素 的 子 元 素 ; 二 是 用 @FacesValidator 型 标注 修饰 验证 器 类 。 

下 面 是 在 Faces 配置 文件 中 注册 验证 器 类 的 一 个 示例 。 


<faces-config ....... > 
<validator> 
<validator-id>myvalidator</validator-id> 
<validator-class>validator.MyValidator</validator-class> 
</validator> 


</faces-config> 


其 中 validator-id 子 元 素 指 定 注册 的 验证 器 类 的 注册 ID, validator-class 子 元 素 指定 该 验证 
器 类 的 完整 类 名 。 
下 面 是 采用 标注 方式 注册 验证 器 类 的 示例 ,此 时 只 需 在 标注 中 指定 注册 ID。 


Q@FacesValidator ("myvalidator") 


public class MyValidator implements Validator{...} 


需要 时 ,可 以 用 自 定义 验证 器 替换 标准 验证 器 。 例 如 ,车 在 注册 validator. MyValidator 
验证 器 类 时 ,指定 注册 ID 为 javax. faces. Length (为 标准 验证 器 类 LengthValidator 的 注册 
ID) ,那么 当 按 以 下 方式 引用 验证 器 时 : 

<f:validateLength/> 
或 

<f:validator validatorId="javax.faces.Length"/> 
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实际 引用 的 将 不 再 是 标准 验证 器 LengthValidator, 而 是 上 述 自 定义 验证 器 。 
7.6.3 自 定义 验证 器 应 用 示例 


本 例 继 续 第 7. 3. 3 小 节 中 介绍 的 JSF 应 用 ,为 其 添加 一 个 自 定义 验证 器 ,用 于 检验 用 户 
输入 的 ISBN 编号 是 否 正 确 。ISBN 编号 通常 由 13 位 数字 组 成 ,其 中 第 13 位 ( 即 最 后 一 位 ) 
是 校 验 码 。 校 验 码 的 计算 方法 如 下 : 

(1) 分 别 用 1 乘 以 编号 前 面 12 位 中 的 各 奇数 位 、3 乘 以 各 偶数 位 ; 

(2) 将 上 面 所 有 的 乘积 相 加 得 到 总 和 ,然后 再 用 该 总 和 除 以 10 得 到 一 个 余数 ; 

(3) 用 10 减 去 上 面 得 到 的 余数 得 到 一 个 差 , 如 果 差 为 10, 则 校 验 码 为 0, 和 否则 差 即 为 校 


验 码 。 


下 面 介 绍 具体 的 实现 方法 。 首 先 创 建 Java 包 validator, 并 在 包 中 创建 自 定 义 验证 器 类 
ISBN Validator. java, 具 体 代 码 如 代码 清单 7-6 所 示 。 
代码 清单 7-6” 自 定义 验证 器 类 (ISBNValidator. java) 


1。 
2. 
3. 
4. 
5。 
6. 
7。 
8. 
9 


10. 
hs 
12。 
13。 
14. 
15。 
16 . 
17。 
18 . 
19 
20 . 
21s 
22、 
23， 
24. 
25。 
26 . 
27。 
28 . 
29。 
30 
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package validator; 


import javax. 
import javax. 
import javax. 
import javax. 


import javax. 


faces 
faces 
faces 
faces 


faces 


.application.FacesMessage; 
.component .UIComponent; 
.Context.FacesContext; 
.validator.Validator; 


.validator.ValidatorException; 


public class ISBNValidator implements Validator { 


public void validate (FacesContext context,UIComponent component,Object value) 


throws ValidatorException { 


StringBuilder sb=new StringBuilder (String.valueOf (value)); 


boolean success=true; 
if(sb.length()!=13){ 
success=false; 


} else { 


int sum=0; 


for (int i=0;i<11;i=i+2){ 
sum=sum +1* (sb.charAt (i)-48) +3* (sb.charAt (i+1)-48); 


} 


System.out.println("sum="+sum); 


int c=10 -sum$%10; 
if(c==10) c=0; 
if(sb.charAt (12)-48!=c) success=false; 


} 


if(!success){ 
String s="ISBN 编号 错误 ,请 重新 输入 !"; 


FacesMessage msg=new FacesMessage (s,s); 


throw new ValidatorException (msg); 


} 
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然后 注册 该 验证 器 类 ,在 Faces 配置 文件 (faces-config. xml) 中 进行 声明 , 见 代 码 清单 7-7。 
代码 清单 7-7 注册 自 定义 验证 器 类 (validator. ISBNValidator) 


1. <?xml version= '1.0' encoding='UTF- 8'?> 


2. <faces-config version="2.0" "> 

Bs 

4 <validator> 

5 <validator-id>isbnvalidator</validator-id> 

6. <validator-class>validator.ISBNValidator</validator-class> 
7 </validator> 

8. </faces-config> 


最 后 在 欢迎 页 面 (index. xhtml) 的 文本 域 组 件 标记 中 用 f:validator 子 标记 引用 已 注册 


的 自 定义 验证 器 , 见 代 码 清单 7-8。 


代码 清单 7-8 ”在 页 面 index. xhtml 中 引用 自 定义 验证 器 


1. <h:inputText id="isbn" value="# {myBean.isbn}"> 
Ds se 
3. <f:validator validatorId="isbnvalidator"/> 


4. </h:inputText> 


1.7 不 结 


。 转换 器 模型 的 编程 主要 涉及 定义 转换 器 类 ,注册 转换 器 类 和 引用 转换 器 等 三 方面 的 
工作 。 
。 标准 转换 器 由 JSF 规范 定义 、 随 JSF 实现 一 起 提供 给 用 户 ,主要 用 于 一 些 常见 的 
Java 类 型 的 组 件 值 与 其 字符 串 文 本 表示 之 间 的 转换 。 
。 转换 器 类 可 按 ID 注册 ,也 可 按 类 型 注册 。 所 有 的 标准 转换 器 都 自动 完成 按 ID 注册 
或 者 按 类 型 注册 。 
。 引用 转换 器 的 方式 包括 : 默认 方式 (基于 类 型 )、 通 过 ID 引用、 直接 引 用 以 及 使 用 专 
用 标记 引用 特定 的 标准 转换 器 。 
。 自 定义 转换 器 类 必须 实现 Converter 接口 ,提供 getAsObject 方法 和 getAsString 方 
法 的 实现 。 
。 验证 器 模型 的 编程 主要 涉及 定义 验证 器 类 、 注 册 验 证 器 类 和 引用 验证 器 等 三 方面 的 
玉 作 。 
。 标准 验证 器 由 JSF 规范 定义 、 随 JSF 实现 一 起 提供 给 用 户 , 主 要 用 于 完成 一 些 基本 
的 组 件 值 验证 处 理 功 能 。 
。 验证 器 类 只 按 ID 进行 注册 。 所 有 标准 验证 器 类 都 自动 完成 注册 。 
。 引用 验证 器 的 方式 包括 : 通过 ID 引用 、 引 用 独立 的 验证 方法 、 直 接 引 用 以 及 使 用 专 
用 标记 引用 特定 的 标准 验证 器 。 
。 自 定义 验证 器 类 必须 实现 Validator 接口 ,提供 validate 方法 的 实现 。 
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习 题 7 


1. 转换 器 和 验证 器 的 作用 是 什么 ? 

2. 结合 转换 器 和 验证 器 , 简 述 “处 理 验证 ”阶段 的 基本 过 程 。 

3. 注册 转换 器 类 和 验证 器 类 的 方式 有 哪 几 种 ? 标准 转换 器 类 和 标准 验证 器 类 的 注册 
情况 如 何 ? 

4. 简 述 引用 转换 器 和 验证 器 的 各 种 方式 及 其 特点 。 

5. 如何 自 定义 一 个 转换 器 ? 如 何 自 定义 一 个 验证 器 ? 

6. 修改 应 用 项 目 sh4_logandreg( 第 4 章 习 题 5) 中 的 登录 功能 : 编写 一 个 自 定义 验证 
器 ,用 以 验证 用 户 输入 的 用 户 名 和 密码 是 否 合法 。 同 时 对 原来 的 动作 方法 做 必要 的 修改 , 即 
删 去 有 关上 述 验证 功能 的 代码 。 
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第 8 章 JSF 事件 处 理 


本 章 主题 : 

。 JSF 事件 处 理 概述 

。 动作 事件 及 其 处 理 
。 值 变化 事件 及 其 处 理 
。 阶段 事件 及 其 处 理 
。 系统 事件 及 其 处 理 


JSF 是 一 种 以 组 件 为 中 心事 件 驱动 编程 模型 为 基础 的 Web 应 用 的 用 户 界 面 软件 框 
架 。 了 解 JSF 的 事件 处 理 机 制 ,掌握 事件 处 理 编程 技术 ,对 JSF 应 用 开发 人 员 来 说 是 必 不 
可 少 的 。 


8. 1 JSF 事件 处 理 概 述 


JSF 事件 模型 基于 JavaBean 事件 模型 ,简称 事件 一 监听 器 模型 。 事件 泛 指 对 象 的 某 种 
状态 变化 ,其 中 的 对 象 称 为 事件 源 。 当 一 个 事件 引发 时 ,事件 源 能 够 将 该 事件 通告 给 对 这 种 
事件 感 兴趣 的 监听 器 。 监 听 器 接收 到 通告 后 ,可 以 了 解 事件 的 属性 ,并 可 根据 需要 进行 相应 
的 处 理 和 响应 ,如 图 8-1 所 示 。 一 个 监听 器 若 对 某 个 事件 源 的 某 种 事件 感 兴趣 ,应 该 先进 行 


注册 。 
事件 1 事件 2 
事件 源 1 
事件 监听 器 2 


事件 3 


事件 源 2 


事件 监听 器 3 
图 8-1 事件 一 监听 器 模型 


在 事件 一 监听 器 模型 中 ,一 个 事件 源 可 以 引发 多 种 类 型 的 事件 ,如 图 中 事件 源 2 可 以 引 
发 两 种 类 型 的 事件 (事件 2 表示 某 种 类 型 的 事件 ,事件 3 表示 另 一 种 类 型 的 事件 )。 对 一 个 
事件 源 引发 的 某 种 类 型 的 事件 ,可 以 有 多 个 事件 监听 器 感 兴趣 ,如 图 中 事件 监听 器 1 和 事件 
监听 器 2 都 对 事件 源 1 的 一 种 事件 类 型 感 兴趣 . 当 这 种 类 型 的 一 个 事件 引发 时 ,事件 源 1 将 
依次 通告 给 上 述 两 个 监听 器 。 一 个 监听 器 也 可 以 对 多 个 事件 源 引 发 的 事件 感 兴趣 ,如 图 中 
事件 监听 器 1 既 对 事件 源 1 引发 的 事件 、 也 对 事件 源 2 引发 的 事件 感 兴 趣 。 

1. 事件 与 事件 源 
事件 用 事件 类 的 实例 表示 。 在 JSF 中 ,事件 分 三 大 类 : Faces 事件 、 阶 段 事 件 和 系统 事 
件 , 如 图 8-2 所 示 。 图 中 除 EventObject 属于 java. util 包 , 其 他 事件 类 都 属于 javax. faces. 
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event 包 。 


java.util.EventObject 


FacesEvent PhaseEvent | SystemEvent 


ActionEvent ValueChangeEvent ComponentSystemEvent 


图 8-2 JSF 事件 类 型 


Faces 事件 又 称 应 用 事件 ,由 用 户 界面 组 件 引 发 和 广播 。Faces 事件 的 基 类 是 
FacesEvent, 包 括 动作 事件 (ActionEvent) 和 值 变 化 事件 (ValueChangeEvent)。 动 作 事 件 由 
UICommand 组 件 引 发 ,包括 HtmlCommandButton 和 HtmlCommandLink 组 件 。 动 作 事 
件 表示 用 户 在 界面 上 单 击 这 些 组 件 呈现 的 递交 按钮 或 超 链 接 。 值 变化 事件 由 UIInput 组 件 
引发 ,包括 基本 输入 类 组 件 、 选 择 类 组 件 和 视图 参数 组 件 。 值 变化 事件 表示 用 户 为 某 个 
UIInput 组 件 指定 了 一 个 新 值 。 

阶段 事件 的 事件 源 是 Lifecycle 型 对 象 。 阶 段 事件 表示 JSF 请 求 处 理 生 命 周 期 中 某 个 
阶段 的 开始 或 结束 。 

与 阶段 事件 类 似 , 系 统 事件 表示 JSF 应 用 在 运行 期 间 的 某 个 特定 的 时 间 点 ,如 JSF 应 
用 启动 完成 、 某 组 件 已 被 添加 到 视图 等 。 系 统 事 件 是 一 类 事件 的 总 称 。 具 体 的 系统 事件 类 
型 应 该 扩展 SystemEvent 抽象 类 ,其 事件 源 可 以 是 某 种 任意 类 型 对 象 。 

组 件 系 统 事 件 是 事件 源 为 某 种 UIComponent 对 象 的 系统 事件 。 具 体 的 组 件 系 统 事件 
类 型 应 该 扩展 ComponentSystemEvent 抽象 类 。 

2. 监听 器 与 监听 器 接口 

监听 器 是 监听 器 类 的 实例 ,包含 用 于 处 理事 件 的 方法 。 所 谓 事件 源 将 事件 通告 给 监听 
器 , 指 的 就 是 调用 监听 器 中 的 事件 处 理 方法 。 

一 般 来 说 ,一 个 监听 器 接口 对 应 于 某 种 事件 类 型 ,声明 了 用 于 处 理 该 种 事件 的 方法 签 
名 。 一 个 具体 的 监听 器 类 必须 实现 监听 器 接口 ,提供 接口 中 声明 的 方法 的 实现 。 图 8-3 给 
出 了 JSF 规范 包含 的 一 些 主要 监听 器 接口 及 其 继承 关系 。 


java.util. EventListener 


FacesListener PhaseListener 


| ActionListener SystemEventListener 


ValueChangeListener | | ComponentSystemEventListener 


图 8-3 JSF 监听 器 接口 
这 里 ,ActionListener 型 监听 器 用 于 监听 、 处 理 动作 事件 ;ValueChangeListener 型 监听 
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器 用 于 监听 、 处 理 值 变化 事件 ;PhaseListener 型 监听 器 用 于 监听 、 处 理 阶 段 事 件 。 

如 上 所 述 ,通常 一 种 事件 类 型 对 应 一 个 监听 器 接口 ,但 对 系统 事件 和 组 件 系 统 事 件 并 非 
如 此 。 系 统 事件 和 组 件 系统 事件 都 是 一 类 事件 的 总 称 。 但 不 管 是 哪 种 具体 的 系统 事件 类 
型 ,其 监听 器 类 都 应 该 实现 SystemEventListener 接口 。 对 于 具体 的 组 件 系统 事件 类 型 ,其 
相应 监听 器 类 则 可 以 通过 实现 ComponentSystemEventListener 接口 来 定义 。 

要 掌握 事件 处 理 编程 ,首先 要 了 解 各 种 事件 类 型 及 其 事件 源 ,其 次 要 能 够 扩展 监听 器 接 
口 定义 监听 器 类 和 监听 器 方法 ,最 后 要 知道 如 何 向 事件 源 注册 监听 器 。 


8.2 动作 事件 及 其 处 理 


本 节 介绍 动作 事件 的 含义 、 引 发 机 制 ,以 及 动作 事件 的 监听 与 处 理 。 
8.2.1 动作 事件 


动作 事件 用 ActionEvent 事件 类 的 实例 对 象 表示 。 动 作 事件 由 实现 了 ActionSource 接 
口 ( 属 于 javax. faces. component 包 ) 的 UICommand 组 件 ( 也 称 为 动作 组 件 ) 引 发 。 在 JSF 
规范 中 ,这 类 组 件 包括 HtmlCommandButton 和 HtmlCommandLink 组 件 。 

上 述 两 个 组 件 在 用 户 界 面 中 分 别 呈现 为 动作 按钮 或 动作 超 链接 。 当 用 户 单 击 动作 按钮 
或 动作 超 链接 时 ,将 产生 一 个 POST 回 送 请 求 , 其 中 的 请 求 参数 就 包含 该 动作 按钮 或 动作 
超 链接 的 值 本 身 。 该 请 求 将 由 JSF 框架 处 理 。 在 请 求 处 理 生 命 周 期 的 “应 用 请 求 值 ”阶段 ， 
若 JSF 框架 检测 到 请 求 参 数 有 某 动 作 按 钮 或 动作 超 链接 的 值 , 表 明 该 动作 按钮 或 动作 超 链 
接 已 被 用 户 激 活 , 此 时 JSF 框架 将 为 相应 的 HtmlCommandButton 或 HtmlCommandLink 
组 件 创建 一 个 动作 事件 。 

动作 事件 的 创建 需 用 到 ActionEvent 类 中 的 以 下 构造 方法 ,其 中 传人 的 组 件 参数 应 该 
是 实现 ActionSource 接口 的 HtmlCommandButton 组 件 或 HtmlCommandLink 组 件 。 


public ActionEvent (UIComponent component) 


动作 事件 具有 以 下 实例 方法 ,可 以 返回 该 事件 的 事件 源 ,也 即 在 创建 动作 事件 时 指定 的 
动作 按钮 组 件 或 动作 超 链接 组 件 。 


public UIComponent getComponent () 


动作 事件 创建 后 并 不 会 马上 处 理 , 而 是 被 先 放 到 事件 队列 中 。 直 到 整个 “应 用 请 求 值 ” 
阶段 结束 或 进入 “调用 应 用 ”阶段 ,动作 事件 才 会 从 事件 队列 中 取出 并 被 处 理 。 

默认 情况 下 (组 件 的 immediate 属性 值 为 false) ,动作 事件 将 在 “调用 应 用 ”阶段 被 广播 
至 已 在 动作 组 件 上 注册 对 动作 事件 感 兴趣 的 监听 器 。 如 果 组 件 的 immediate 属性 值 为 
true, 那 么 动作 事件 会 在 “应 用 请 求 值 ”阶段 结束 时 被 广播 至 已 注册 的 对 动作 事件 感 兴趣 的 
监听 器 。 


8.2.2 动作 监听 器 


对 动作 事件 感 兴趣 的 监听 器 称 为 动作 监听 器 ,是 实现 ActionListener 接口 的 监听 器 类 
的 实例 。ActionListener 接口 仅 声明 了 一 个 用 于 处 理 动 作 事件 的 processAction 方法 。 
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public void processAction (ActionEvent event) throws AbortProcessingException 


AbortProcessingException 是 定义 于 javax. faces. event 包 的 一 个 不 受 检查 的 运行 时 例 
外 。 方 法 抛 出 该 例外 的 作用 是 通知 JSF 框架 : 该 事件 不 必 做 进一步 的 处 理 , 即 不 需要 再 广 
播 至 其 他 的 监听 器 。 

下 面 代码 是 一 个 简单 的 动作 监听 器 类 的 示例 ,其 中 用 于 处 理 动作 事件 的 processAction 
方法 象征 性 地 输出 了 一 条 信息 。 


package listener; 
import javax.faces.event.ActionListener; 
import javax.faces.event.ActionEvent; 
public class MyActionListener implements ActionListener { 
public void processAction (ActionEvent ae){ 
System.out .println("MyActionListener is Processing an action event..."); 
} 
} 


8.2.3 注册 动作 监听 器 


一 个 监听 器 要 监听 和 处 理 某 个 组 件 引 发 的 事件 ,必须 预先 在 该 组 件 上 注册 。 每 种 组 件 
都 会 提供 一 组 合适 的 方法 用 以 注册 相应 的 监听 器 。 比 如 UICommand 组 件 的 下 面 方法 就 用 
以 在 组 件 上 注册 一 个 动作 监听 器 。 


Public void addActionListener (ActionListener listener) 


在 JSF 中 ,更 常用 的 方法 是 采用 声明 的 方式 在 页 面 文件 中 注册 所 需 的 动作 监听 器 。 具 
体 做 法 是 : 在 引发 动作 事件 的 动作 组 件 标 记 中 嵌入 f:actionListener 核心 标记 。 


<h:commandButton value= "OK" action="#{myBean.m}"> 
<f:actionListener type="listener.MyActionListener"/> 


</h:commandButton> 


上 面 代码 中 ,f:actionListener 标记 type 属性 指定 监听 器 类 的 完整 类 名 。 当 JSF 框架 处 
理 视图 时 会 在 其 父 标记 组 件 ( 即 动作 按钮 组 件 ) 上 注册 一 个 指定 类 型 的 监听 器 对 象 。 

可 以 在 动作 按钮 组 件 标 记 或 动作 超 链 接 组 件 标 记 中 艇 入 多 个 f:actionListener 标记 , 达 
到 注册 多 个 监听 器 的 目的 。 如 果 注 册 了 多 个 监听 器 ,引发 的 动作 事件 将 按 注册 的 顺序 ( 即 声 
明 的 顺序 ) 依 次 通告 给 各 动作 监听 器 。 

也 可 以 通过 动作 组 件 标 记 的 actionListener 属性 注册 一 个 独立 的 动作 监听 方法 。 下 面 
代码 演示 了 这 种 方法 的 使 用 。 


<h:commandButton value= "OK" actionListener="#{myBean.method}" action= 


"#{myBean .mj"/> 
这 里 ,actionListener 属性 指定 一 个 方法 表达 式 ,其 所 指 的 方法 称 为 独立 的 动作 监听 方法 。 
当 动 作 事件 引发 时 ,该 动作 监听 方法 将 被 通告 (调用 )。 动 作 监 听 方法 的 方法 签名 应 该 
如 下 : 
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public void < 方法 名 > (ActionEvent ae) 
或 

public void < 方法 名 > () 

说 明 : 事实 上 ,JSF 框架 在 处 理 动作 组 件 标记 的 actionListener 属性 时 ,会 自动 创建 一 
个 类 型 为 javax. faces. event. MethodExpressionActionListener 的 监听 器 ,并 注册 在 动作 组 
件 上 。 该 监听 器 的 processAction 方法 将 调用 actionListener 属性 指定 的 方法 。 

对 一 个 动作 组 件 , 除 了 通过 f:actionListener 子 标记 和 actionListener 属性 注册 的 监听 器 和 
独立 监听 方法 外 ,JSF 框架 还 会 提供 一 个 默认 的 监听 器 ,该 默认 监听 器 的 processAction 方法 会 
调用 action 属性 指定 的 动作 方法 ,并 以 动作 方法 返回 的 结果 值 为 参数 .调用 导航 处 理 器 的 导 
航 方 法 进行 导航 处 理 。 

对 一 个 动作 组 件 , 如 果 既 注册 了 动作 监听 器 (可 以 有 多 个 ) ,又 指定 了 动作 监听 方法 和 动 
作 方 法 ,那么 将 按 以 下 顺序 通告 和 调用 : 

。 actionListener 属性 指定 的 动作 监听 方法 。 

。 f:actionListener 标记 指定 的 监听 器 ( 按 声明 顺序 )。 

。 action 属性 指定 的 动作 方法 。 


8.3 值 变化 事件 及 其 处 理 


本 节 介绍 值 变化 事件 的 含义 .引发 机 制 , 以 及 值 变化 事件 的 监听 与 处 理 。 
8.3.1 值 变 化 事件 


值 变化 事件 用 ValueChangeEvent 事件 类 的 实例 对 象 表示 。 值 变化 事件 的 事件 源 是 实 
现 了 EditableValueHolder 接口 (属于 javax. faces. component 包 ) 的 UIInput 组 件 。 在 JSF 
规范 中 ,这 类 组 件 包 括 基本 输入 类 组 件 .选择 类 组 件 和 视图 参数 组 件 等 。 

如 果 一 个 请 求 包含 与 某 个 UIInput 组 件 对 应 的 请 求 参 数 ,那么 该 请 求 参数 将 被 该 组 件 
读 入 ,然后 进行 类 型 转换 和 验证 处 理 。 当 一 个 UIInput 组 件 的 值 通过 了 验证 、 且 其 新 值 不 同 
于 原 有 的 值 ,JSF 框架 将 为 相应 的 UIInput 组 件 创 建 一 个 值 变 化 事件 。 

值 变化 事件 的 创建 需 用 到 ValueChangeEvent 类 中 的 以 下 构造 方法 ,其 中 传人 的 第 一 
个 组 件 参数 应 该 是 引发 该 事件 的 具体 的 UIInput 组 件 ; 第 二 个 参数 应 该 是 组 件 原 有 的 值 ;第 
三 个 参数 应 该 是 组 件 的 新 值 。 


public ValueChangeEvent (UIComponent component, Object oldValue, Object newValue) 


值 变化 事件 具有 以 下 实例 方法 ,可 以 返回 该 事件 的 事件 源 ,以 及 该 事件 源 组 件 的 原 值 和 
新 值 。 
。 public UIComponent getComponent( )。 
。 public Object getOldValue() 。 
。 public Object getNewValue() 。 
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值 变化 事件 创建 后 并 不 会 马上 处 理 , 而 是 被 先 放 到 事件 队列 中 。 直 到 验证 处 理 所 在 阶 
段 结 束 , 值 变化 事件 才 会 从 事件 队列 中 取出 并 被 处 理 。 

默认 情况 下 (组 件 的 immediate 属性 值 为 false) , 值 变 化 事件 将 在 “处 理 验 证 ”阶段 结束 
时 被 广播 至 已 在 组 件 上 注册 对 值 变化 事件 感 兴趣 的 监听 器 。 如 果 组 件 的 immediate 属性 值 
为 true, 那 么 组 件 值 的 验证 会 在 “应 用 请 求 值 ” 阶 段 进行 .相应 地 ,该 组 件 引 发 的 值 变 化 事件 
将 在 “应 用 请 求 值 ”阶段 结束 时 被 广播 至 已 注册 的 对 值 变化 事件 感 兴趣 的 监听 器 。 


8. 3.2 值 变化 监听 器 


对 值 变 化 事件 感 兴趣 的 监听 器 称 为 值 变化 监听 器 ,是 实现 ValueChangeListener 接口 
的 监听 器 类 的 实例 。ValueChangeListener 接口 仅 声 明了 一 个 用 于 处 理 值 变化 事件 的 
方法 。 


public void processValueChange (ValueChangeEvent event) throws AbortProcessingException 


AbortProcessingException 是 一 个 不 受 检查 的 运行 时 例外 。 方 法 抛 出 该 例外 的 作用 是 
通知 JSF 框架 : 该 事件 不 必 做 进一步 的 处 理 , 即 不 需要 再 广播 至 其 他 的 监听 器 。 

下 面 代码 是 一 个 简单 的 值 变化 监听 器 类 的 示例 ,其 中 processValueChange 方法 只 是 象 
征 性 地 输出 了 事件 源 组 件 的 值 的 变化 。 


package listener; 
import javax.faces .event .ValueChangeEvent; 
import javax.faces.event.ValueChangeListener; 
public class MyValueChangeListener implements ValueChangeListener { 
public void processValueChange (ValueChangeEvent event){ 
System.out .println("Event Source:"+evVvent .getComponent ()); 
System.out .Println("Old Value:" +event .getOldValue ())， 


System.out .println("New Value:" +event .getNewValue ()); 
} 


8.3.3 注册 值 变 化 监听 器 


值 变化 监听 器 要 监听 和 处 理 某 个 UIInput 组 件 引发 的 值 变化 事件 ,必须 预先 在 该 组 件 
上 注册 。UIInput 组 件 提 供 以 下 方法 用 以 注册 一 个 值 变化 监听 器 。 


public void addValueChangeListener (ValueChangeListener listener) 


在 JSF 中 ,采用 声明 的 方式 注册 值 变 化 监听 器 是 一 种 更 常用 的 方法 。 具 体 做 法 是 : 在 
引发 值 变化 事件 的 UIInput 组 件 标记 中 骨 入 f:valueChangeListener 核心 标记 。 


<h:inputText value="# {myBean.degree}"> 
<f:valueChangeListener type="listener.MyValueChangeListener"/> 
</h:inputText> 


这 里 ,f:valueChangeListener 标记 的 type 属性 指定 值 变化 监听 器 类 的 完整 类 名 。 当 JSF 框 
架 处 理 该 组 件 标记 时 会 在 其 父 UIInput 组 件 ( 上 面 示例 中 即 为 HtmlInputText 组 件 ) 上 注 
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册 一 个 指定 类 型 的 监听 器 对 象 。 

可 以 在 某 种 UIInput 组 件 标 记 中 艇 入 多 个 f: valueChangeListener 标记 ,达到 注册 多 个 
值 变化 监听 器 的 目的 。 如 果 注 册 了 多 个 监听 器 .引发 的 值 变化 事件 将 按 注册 的 顺序 ( 即 声明 
的 顺序 ) 依 次 通告 给 各 值 变化 监听 器 。 

也 可 以 通过 某 种 UIInput 组 件 标记 的 valueChangeListener 属性 注册 一 个 独立 的 值 变 
化 监听 方法 。 下 面 是 使 用 该 属性 的 一 个 示例 。 


<h:inputText value="# {myBean.degree}" valueChangeListener="# {myBean.method}"/> 


这 里 ,valueChangeListener 属性 指定 一 个 方法 表达 式 , 其 所 指 的 方法 称 为 值 变 化 监听 方法 。 
当 值 变化 事件 引发 时 ,该 值 变 化 监听 方法 将 被 通告 (调用 )。 值 变化 监听 方法 的 方法 签名 应 
该 如 下 : 


public void < 方法 名 > (ValueChangeEvent vce) 
或 
public void < 方法 名 > () 


说 明 : 事实 上 ,JSF 框架 在 处 理 某 种 UIInput 组 件 标记 的 valueChangeListener 属性 时 ， 
会 自动 创建 一 个 类 型 为 javax. faces. event. MethodExpressionValueChangeListener 的 监听 
器 对 象 , 并 注册 在 该 UIInput 组 件 上 。 该 监听 器 的 processValueChange 方法 将 调用 
valueChangeListener 属性 指定 的 方法 。 

对 一 个 UIInput 组 件 , 如 果 既 注册 了 值 变化 监听 器 (可 以 有 多 个 ) ,又 指定 了 值 变化 监听 
方法 ,那么 将 按 以 下 顺序 通告 和 调用 ， 

。 valueChangeListener 属性 指定 的 值 变化 监听 方法 。 
。 f:valueChangeListener 标记 指定 的 监听 器 ( 按 声 明 顺 序 ) 。 


8.3.4 值 变化 事件 应 用 示例 


该 应 用 项 目 (ch8_valuechange) 包 含 一 个 JSF 页 面 、 一 个 受 管 bean 和 三 个 Java 类 。 应 
用 的 运行 效果 如 图 8-4 所 示 。 


值 变 化 事件 示例 - Wozilla Firefox 
文件 四 编辑 人 E) 查看 WW) 历史 G) 书签 B) 工具 IT 帮助 人 0 仿 


@ - BB -|[B Mtp://1ocalhost:8080/chB_valuechange/ faces/index. xhtnl 


部 门 名 称 :| 信息 学 院 国 | 教师 姓名 :| 请 选择 ... 国 | [确认 
所 选 教师 职工 号 : 


图 8-4 应 用 ch8_valuechange 运行 效果 图 


当 用 户 从 “部 门 名 称 ” 单 选 菜 单 中 选择 不 同 部 门 ( 值 变 化 ) 时 ,“ 教 师 姓 名 " 单 选 菜单 中 的 
选项 会 发 生 相应 的 变化 , 即 变 成 了 指定 部 门 的 所 有 教师 的 姓名 。 当 用 户 单 击 “ 确 认 ” 按 钮 时 ， 
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页 面 下 方 会 显示 所 选 教师 的 职工 号 。 

1. 模型 

该 应 用 的 模型 包括 三 个 Java 类 .都 属于 model 包 。 第 一 个 类 是 表示 部 门 的 Department 
类 , 见 代码 清单 8-1。 其 中 包含 两 个 可 读 的 实例 变量 ,实例 变量 相应 的 getter 方法 在 代码 清 
单 中 被 省 略 了 。 

代码 清单 8-1 model. Department 类 


1. package model; 
有 
3. public class Department { 
4 private String did; // 部 门 编号 
5. private String dname; // 部 门 名 称 
6 
和 public Department (){ 
8 } 
9. public Department (String did,String dname){ 
10. this.did=did; 
11. this.dname=dname; 
12。 } 
Lose a // 实 例 变 量 相 应 的 getter 方法 
14.} 


第 二 个 类 是 表示 教师 的 Teacher 类 , 见 代码 清单 8-2。 其 中 包含 三 个 可 读 的 实例 变量 ， 
实例 变量 相应 的 getter 方法 在 代码 清单 中 被 省 略 了 。 
代码 清单 8-2 ”model. Teacher 类 


1. package model; 

2 

3. public class Teacher { 

4 Private String tid; // 职 工 号 
5. private String tname; // 教 师 姓名 
6 private String did; // 所 属 部 门 
7 

8 public Teacher (){ 

9 } 


10。 public Teacher (String tid,String tname,String did){ 


Ys this.tid=tid; 

12, this.tname=tname; 

3 this.did=did; 

14. } 

LG ah // 实 例 变 量 相 应 的 getter 方法 
16. } 


最 后 一 个 类 是 模拟 业务 数据 的 DataBase 类 , 见 代码 清单 8-3。 该 类 定义 了 两 个 类 变量 ， 
其 中 depts 引用 一 个 部 门 表 ,teachers 引用 一 个 教师 表 , 这 两 个 表 在 类 装 人 时 被 初始 化 。 
2 


代码 清单 8-3 model. DataBase 类 


. Package model; 
. import java.util.ArrayList; 


. import java.util.List; 


private final static List<Department>depts=new ArrayList<Department> (); 


1 

2 

癌 

4 

5. public class DataBase { 
6 

7 Private final static List<Teacher>teachers=new ArrayList<Teacher> (); 
8 


static { 

L depts.add (new Department ("01", "外 语系 ")); 
10. depts.add (new Department ("02", "信息 学 院 ")); 
b teachers .add (new Teacher ("0001"," 李 小明 ","02")); 
12, teachers .add (new Teacher ("0002"," 吴 英 ", "01")); 
33， teachers .add (new Teacher ("0003"，" 刘 京 其 ","02")) 7 
14. teachers .add (new Teacher ("0004"," 赵 永 义 ","01"))， 
15, teachers.add (new Teacher ("0005", " 郝 杰 ", "02") ); 
16。 


17. // 返 回 所 有 的 部 门 

18. Ppublic static List<Department>getDepartments(){ 

19。 return depts; 

20 .。 

21. // 根 据 部 门 编号 aid 返回 该 部 门 的 所 有 教师 

22. public static List<Teacher>getTeachers (String did){ 


2 List<Teacher>list=new ArrayList<Teacher> (); 
24. for (Teacher 七 :teachers){ 

2 if(t.getDid() .equals (did)) list.add(t); 
26。 } 

人 215 return list; 

28。 } 

29..3 

2. 受 管 bean 


该 应 用 定义 了 一 个 视图 作用 域 的 受 管 bean 类 , 即 bean. Index, 见 代码 清单 8-4。 其 中 
包含 两 个 只 读 属 性 和 两 个 可 读 写 属性 ,这 些 属性 相应 的 getter 方法 和 setter 方法 在 代码 清 
单 中 被 省 略 了 。 

代码 清单 8-4 受 管 bean(bean. Index) 


. Package bean; 

. import java.io.Serializable; 

. import java.util.ArrayList; 

. import java.util.List; 

. import javax.faces .bean.ManagedBean; 


. import javax.faces .bean.ViewSscoped; 
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. import javax.faces.context.FacesContext; 


8. import javax.faces .event .ValueChangeEvent; 
9. import javax.faces .model.SelectItem; 

10. import model .DataBase; 

11. import model .Department; 


12. import model.Teacher; 


14. @ManagedBean 

15. @ViewScoped 

16. public class Index implements Serializablef 

17. // 只 读 属性 ,为 “部 门 名 称 ” 单 选 荣 单 提供 选项 

18. private List<SelectItem>depts=new ArrayList<SelectItem> (); 
19. // 只 读 属性 ,为 “教师 姓名 ” 单 选 荣 单 提供 选项 

20. private List<SelectIitem>teachers; 

21. // 可 读 写 属性 ,存放 “部 门 名 称 " 单 选 菜单 的 值 , 即 所 选 部 门 的 部 门 号 
22. private String did; 

23. // 可 读 写 属性 ,存放 “教师 姓名 " 单 选 菜单 的 值 , 即 所 选 教师 的 职工 号 
24. Private String tid; 
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PA public Index(){ 

1 SelectItem item=new SelectItem(); 

28. item.setLabel(" 请 选择 ...") 7 

29. item.setNoSelectionOption(true); 

二 和 depts.add (item); 

ly List<Department>ds=DataBase.getDepartments (); 

i for (Department d : ds){ 

33 . depts .add (new SelectItem(d.getDid(),d.getDname ())); 
34 . } 

35。 下 

36. public void valueChange (ValueChangeEvent vce){ 

37, String did= (String)vce .getNewValue (); 

38 .。 teachers=new ArrayList<SelectItem> () 

39s SelectItem item=new SelectItem(); 

40. item.setLabel(" 请 选择 ...") ; 

41. item.setNoSelectionOption(true); 

42. teachers.add (item); 

43. tid=null; 

44. if (did==null) return; 

45. List<Teacher>ts=DataBase .getTeachers (did); 

46. for(Teacher t : ts){ 

47. teachers .add (new SelectItem(t.getTid(),t.getTname())); 
48 . } 

49. FacesContext.getCurrentIinstance() .renderResponse(); 
50. } 

A // 只 读 属性 相应 的 getter 方法 


全 Lo 


2 // 可 读 写 属性 相应 的 getter 方法 和 setter 方 法 
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bean 实例 创建 时 ,depts 属性 被 初始 化 , 且 在 整个 视图 作用 域内 是 不 变 的 。teachers 属 
性 值 在 valueChange 方法 中 被 创建 和 初始 化 。valueChange 方法 是 一 个 值 变 化 监听 方法 ,每 
当 用 户 选 择 不 同 的 部 门 时 ,该 方法 会 被 调用 。 该 方法 最 后 一 行 代 码 (renderResponse 方法 ) 
的 功能 是 : 一 旦 当前 阶段 完成 ,就 绕 过 JSF 请 求 处 理 生命 周期 的 的 其 他 阶段 ,直接 转 入 “ 呈 
现 响 应 ”阶段 。 

3. JSF 页 面 

该 应 用 仅 包 含 一 个 JSF 页 面 . 即 index. xhtml, 见 代码 清单 8-5。 下 面 ,主要 讨论 “部 门 
名 称 ” 单 选 菜单 标记 。 

首先 ,该 标记 的 onchange 属性 指定 为 submit(), 它 使 得 当 用 户 选择 不 同 部 门 时 会 引起 
表单 的 提交 和 请 求 。 这 种 提交 和 请 求 与 单 击 “ 确 认 ” 按 钮 引起 的 表单 提交 和 请 求 是 类 似 的 ， 
都 会 经 历 JSF 请 求 处 理 生 命 周 期 。 但 不 同 的 是 ,前 者 产生 的 请 求 没 有 包含 “确认 ”动作 标记 
相应 的 请 求 参 数 ,所 以 不 会 产生 动作 事件 和 执行 动作 方法 。 

其 次 ,该 标记 的 valueChangeListener 属性 指定 受 管 bean 的 valueChange 方法 为 其 值 
变化 事件 的 监听 方法 。 无 论 何 种 方式 引起 表单 提交 和 请 求 , 如 果 组 件 值 通过 转换 和 验证 , 且 
“部 门 名 称 ” 值 发 生变 化 , 受 管 bean 的 valueChange 方法 就 会 被 调用 。 

最 后 ,该 标记 的 immediate 属性 设置 为 true, 这 使 得 "部门 名 称 ” 值 的 转换 、 验 证 和 值 变 
化 事件 的 监听 处 理 都 将 在 “应 用 请 求 值 ”阶段 进行 ,而 不 会 像 其 他 输入 类 组 件 那样 在 处理 验 
证 ”阶段 进行 。 

综合 以 上 各 点 ,再 考虑 到 valueChange 方法 的 最 后 一 行 代码 是 绕 过 JSF 请 求 处 理 生命 
周期 的 其 他 阶段 .直接 转 入 呈现 响应 阶段 ,可 以 得 出 , 当 用 户 选 择 不 同 部 门 而 引起 表单 提交 
和 请 求 时 ,服务 器 端 所 做 的 主要 工作 就 是 在 “应 用 请 求 值 "阶段 调用 valueChange 方法 .重新 
设置 “教师 姓名 ? 单 选 菜单 的 选项 ( 即 teachers 属性 值 ) ,而 不 会 进入 “处 理 验 证 "“ 更 新 模型 
值 ?等 阶段 ,不 会 对 其 他 组 件 值 进行 转换 和 验证 处 理 。 

代码 清单 8-5 index. xhtml 


1. <?xml version='1.0' encoding= 'UTE-8' ?> 
2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
3. "http://www.w3.0rg/TR/xhtmll/DTD/xhtmll-transitional.dtd"> 
.<html xmlns="http://www.w3.0rg/1999/xhtml" 
xmlns:h="http://java.sun.com/jsf/html" 


xmlns:f="http://java.sun.com/jsf/core"> 


<title> 值 变化 事件 示例 < /title> 
</h:head> 
10. <h:body> 


4 
9 
6 
7. <h:head> 
8 
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要 于 <h:form> 

3 <h:outputLabel for="sl" value=" 部 门 名 称 :"/> 

13, <h:selectOneMenu idq="sl" value="#{index.did}" hideNoSelectionOption="true" 
14. valueChangeListener="#{index.valueChange}" 


5 immediate="true" 


16. onchange="submit ()"> 

EA <f:selectItems value="#{index.depts}"/> 

18. </h:selectOneMenu> 

19. <h:outputLabel for="s2" value=" 教 师 姓 名 :" style="margin-left: 10px"/> 
203 <h:selectOneMenu id="s2" value="#{index.tid}" hideNoSelectionOption="true"> 
21。 <f:selectItems value="#{index.teachers}"/> 

225 </h:selectOneMenu> 

23, <h:commandButton value=" 确 认 " style="margin-left: 10px"/> 

24. </h:form> 

055 <p><h:outputText value=" 所 选 教师 职工 号 :# {index.tid}"/></p> 

26. </h:body> 

27. </html> 


8.4 阶段 事件 及 其 处 理 


本 节 介 绍 阶段 事件 的 含义 ,以 及 阶段 监听 器 类 的 定义 与 阶段 监听 器 的 注册 。 
8.4.1 阶段 事件 


阶段 事件 用 PhaseEvent 事件 类 的 实例 对 象 表示 。 阶 段 事件 的 事件 源 是 Lifecycle 型 对 
象 , 该 生命 周期 对 象 管理 JSF 请 求 处 理 生 命 周 期 的 整个 过 程 ,负责 执行 生命 周期 的 各 个 阶 
段 。 在 请 求 处 理 生 命 周 期 中 ,阶段 状态 的 变化 将 引发 阶段 事件 。 

阶段 事件 的 创建 需 用 到 PhaseEvent 类 中 的 以 下 构造 方法 : 


public PhaseEvent (FacesContext context, PhaselId phaselId, Lifecycle lifecycle) 


第 一 个 参数 为 与 当前 请 求 相 关联 的 FacesContext 对 象 ;第 二 个 参数 是 与 该 阶段 事件 相 
关联 的 请 求 处 理 阶 段 的 阶段 标识 符 ; 第 三 个 参数 是 作为 事件 事件 源 的 生命 周期 对 象 。 

阶段 事件 对 象 具 有 以 下 实例 方法 ,可 以 返回 该 事件 的 事件 源 、 阶 段 标识 符 以 及 请 求 处 理 
上 下 文 对 象 。 

。 Object getSource() 。 

。 Phaseld getPhaseId() 。 

。 FacesContext getFacesContext() 。 

与 动作 事件 和 值 变化 事件 不 同 ,阶段 事件 引发 后 会 被 立刻 广播 给 已 注册 的 、 对 阶段 事件 
感 兴趣 的 监听 器 。 


8.4.2 阶段 监听 器 


对 阶段 事件 感 兴趣 的 监听 器 称 为 阶段 监听 器 ,是 实现 PhaseListener 接口 的 监听 器 类 的 
实例 。PhaseListener 接口 声明 了 以 下 方法 。 
(1) PhaseId getPhaseld() 
返回 请 求 处 理 阶 段 的 阶段 标识 符 ,当前 监听 器 仅 对 该 阶段 的 阶段 事件 感 兴趣 。 
Phaseld 类 定义 了 此 getPhaseld 方法 可 以 返回 的 各 有 效 值 : 
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Phaseld. 
Phaseld. 
Phaseld. 


PhaseId 


ANY_PHASE。 
RESTORE VIEW., 
APPLY_REQUEST_ VALUES 。 


.PROCESS_ VALIDATIONS。 
Phaseld. 
Phaseld. 
Phaseld. 


UPDATE MODEL VALUES. 
INVOKE_APPLICATION 。 
RENDER_RESPONSE。 


如 果 方 法 返回 Phaseld. ANY_PHASE ,表示 当前 监听 器 对 所 有 阶段 的 阶段 事件 都 感 


兴趣 。 


(2) void beforePhase(PhaseEvent event) 

在 监听 器 感 兴趣 的 阶段 的 开始 处 ,该 方法 被 通告 (调用 ) 。 

(3) void afterPhase(PhaseEvent event) 

在 监听 器 感 兴趣 的 阶段 的 结尾 处 ,该 方法 被 通告 (调用 ) 。 

下 面 代码 是 一 个 简单 的 阶段 监听 器 类 的 示例 。 这 种 监听 器 对 所 有 阶段 的 阶段 事件 都 感 
兴趣 ,事件 处 理 方法 只 是 简单 输出 当前 阶段 的 标识 符 。 


package listener; 


import javax.faces.event.PhaseEvent; 


import javax.faces.event.Phaseld; 


import javax.faces.event.PhaseListener; 


public class MyPhaseListener implements PhaseListener{ 


@Override 


Public void beforePhase (PhaseEvent pe){ 
System.out .println ("阶段 :" +pe.getPhaseId() +" 开 始 "); 


} 


@Override 


public void afterPhase (PhaseEvent pe){ 
System.out .println ("阶段 :" +pe.getPhaseId() +" 结 束 "); 


} 


@Override 
public PhaseId getPhaseId(){ 
return PhaselId.ANY PHASE; 


8.4.3 注册 阶段 监听 器 
阶段 事件 的 事件 源 是 Lifecycle 型 对 象 。Lifecycle 型 对 象 提供 以 下 方法 用 以 注册 一 个 
阶段 监听 器 。 


public void addPhaseListener (PhaseListener listener) 


采用 声明 的 方式 注册 阶段 监听 器 是 一 种 更 常用 的 方法 。 一 般 的 做 法 是 在 Faces 配置 文 
件 中 ,用 髓 套 于 lifecycle 元 素 的 phase-listener 子 元 素 指 定 要 注册 的 监听 器 。 
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<faces- config or > 
<lifecycle> 
<phase-listener>listener.MyPhaseListener</phase-listener> 
</lifecycle> 


</faces-confhg> 


phase-listener 元 素 指定 一 个 阶段 监听 器 类 的 完整 类 名 。 在 部 署 JSF 应 用 时 ,指定 类 型 
的 一 个 监听 器 实例 被 自动 创建 ,并 注册 在 生命 周期 对 象 上 。 

上 面 代码 仅 指定 了 一 个 监听 器 ,可 以 在 lifecycle 元 素 能 入 多 个 phase-listener 元 素 指 
定 .注册 多 个 阶段 监听 器 。 各 监听 器 按 声明 的 顺序 注册 。 

当 一 个 阶段 事件 引发 时 ,对 该 事件 感 兴 趣 的 阶段 监听 器 将 被 依次 通告 。 具 体 来 说 ,各 监 
听 器 的 beforePhase 方法 将 按 各 监听 器 的 注册 顺序 依次 被 调用 ;各 监听 器 的 afterPhase 方 
法 将 按 各 监听 器 注册 顺序 的 倒序 依次 被 调用 。 

对 阶段 监听 器 ,还 可 以 在 视图 页 面 中 用 f: phaseListener 核心 标记 将 其 注册 在 视图 根 
上 。 该 标记 可 以 出 现在 页 面 中 根 标记 ( 即 html 标记 ) 内 的 任何 位 置 。 


<f:phaseListener type="listener.MyPhaseListener"/> 


与 Faces 配置 文件 中 的 phase-listener 元 素 相 比较 ,该 标记 只 是 注册 局 部 阶段 监听 器 ， 
即 指定 的 监听 器 只 监听 当前 视图 的 请 求 处 理 过 程 中 引发 的 阶段 事件 。 而 phase-listener 元 
素 指定 的 是 全 局 监听 器 ,这 些 监听 器 会 监听 当前 应 用 中 所 有 请 求 处 理 过 程 中 引发 的 阶段 
事件 。 

如 果 既 注册 了 局 部 监听 器 、 又 包含 全 局 监听 器 ,那么 它们 的 顺序 是 全 局 监听 器 在 前 、 局 
部 监听 器 在 后 。 


8.5 系统 事件 及 其 处 理 


本 节 首 先 介 绍 系统 事件 的 概念 、 特 点 以 及 一 些 具体 的 系统 事件 类 型 ,然后 介绍 系统 事件 
监听 器 类 的 定义 和 系统 事件 监听 器 的 注册 。 


8.5.1 系统 事件 


与 阶段 事件 类 似 , 系 统 事件 表示 JSF 应 用 在 运行 期 间 的 某 个 特定 的 时 间 点 。 但 与 阶段 
事件 相 比 ,系统 事件 表示 的 时 间 点 的 范围 更 广 、 颗 粒度 更 细 , 如 JSF 应 用 启动 完成 、 某 组 件 
已 被 添加 到 视图 等 。 

一 个 具体 的 系统 事件 是 扩展 SystemEvent 抽象 类 的 某 种 具体 类 的 实例 对 象 ,其 事件 源 
可 以 是 某 种 任意 类 型 对 象 。 一 个 具体 的 组 件 系统 事件 是 扩展 ComponentSystemEvent 抽象 
类 的 某 种 具体 类 的 实例 对 象 ,其 事件 源 为 某 种 UIComponent 型 对 象 。 

ComponentSystemEvent 抽象 类 是 SystemEvent 抽象 类 的 子 类 ,所 以 组 件 系统 事件 也 
是 一 种 系统 事件 。 

表 8-1 列 出 了 JSF 规范 提供 的 一 些 具 体 的 系统 事件 类 ,其 中 前 两 个 是 普通 的 系统 事件 
类 ,后 面 五 个 是 组 件 系统 事件 类 。 这 些 事件 类 都 属于 javax. faces. event 包 。 
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表 8-1 系统 事件 与 组 件 系统 事件 


事件 类 名 说 明 事件 源 类 型 
PostConstructApplicationEvent 应 用 程序 正好 启动 完毕 Application 
PreDestroyApplicationEvent 应 用 程序 即将 关闭 Application 
PostAddToViewEvent 组 件 正 好 被 添加 至 视图 UIComponent 
PreValidateEvent 组 件 即 将 被 验证 UIComponent 
PostValidateEvent 组 件 正 好 验证 完毕 UIComponent 
PreRenderViewEvent 视图 (视图 根 ) 即 将 被 呈现 UIViewRoot 
PreRenderComponentEvent 组 件 即 将 被 呈现 UIComponent 


8. 5.2 系统 事件 监听 器 


对 系统 事件 感 兴趣 的 监听 器 称 为 系统 事件 监听 器 ,对 组 件 系统 事件 感 兴趣 的 监听 器 则 
可 称 为 组 件 系 统 事件 监 听 器 。 前 面 已 经 介绍 ,系统 事件 和 组 件 系 统 事件 都 是 一 类 事件 的 总 
称 , 包 含 一 组 具体 的 事件 类 型 ,如 PostConstructApplicationEvent 等 。 但 不 管 是 哪 种 具体 的 
系统 事件 类 型 ,其 监听 器 类 都 应 该 实现 SystemEventListener 接口 。 对 于 具体 的 组 件 系 统 
事件 类 型 ,其 相应 监听 器 类 则 可 以 通过 实现 ComponentSystemEventListener 接口 来 定义 。 

系统 事件 监听 器 接口 , 即 SystemEventListener, 声 明了 两 个 方法 ,其 中 processEvent 方 
法 在 事件 引发 时 被 调用 ,用 于 处 理 系统 事件 ;isListenerForSource 方 法 用 于 检测 该 监听 器 是 
否 对 指定 的 事件 源 感 兴趣 。 


public interface SystemEventListener extends FacesListener { 
void processEvent (SystemEvent event) throws AbortProcessingException; 
boolean isListenerForSource (Object source); 


} 


下 面 是 一 个 具体 的 系统 事件 监听 器 类 的 示例 。 该 监听 器 可 以 监听 由 Application 对 象 
引发 的 各 种 系统 事件 。processEvent 方法 只 是 示意 性 地 输出 了 事件 与 事件 源 的 类 型 名 。 


package listener; 
import javax.faces.application.Application; 
import javax.faces.event.SystemEvent; 
import javax.faces.event.SystemEventListener; 
public class MySystemEventListener implements SystemEventListener { 
public void processEvent (SystemEvent event){ 
System.out .println ("事件 类 型 :"+event .getClass ()); 
System.out .println ("事件 源 类 型 :"+event .getSource() .getClass()); 
public boolean isListenerForSource (Object source){ 


return source instanceof Application; 
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组 件 系统 事件 监听 器 接口 , 即 ComponentSystemEventListener, 仅 声明 了 一 个 用 于 处 
理事 件 的 processEvent 方法 。 


public interface ComponentSystemEventListenerextends FacesListener { 
void processEvent (ComponentSystemEvent event) throws AbortProcessingException; 
} 


由 于 组 件 系统 监听 器 总 是 注册 在 某 个 UIComponent 上 、 监 听 由 该 组 件 引 发 的 系统 事 
件 , 所 以 组 件 系 统 事件 监听 器 并 不 需要 指定 它 对 哪 种 事件 源 引发 的 事件 感 兴趣 。 

需要 注意 ,ComponentSystemEvent 是 SystemEvent 的 子 类 ,所 以 一 个 组 件 系 统 事件 可 
以 被 看 作 是 一 种 普通 的 系统 事件 。 此 时 ,组 件 系 统 事件 可 以 用 普通 的 系统 事件 监听 器 来 监 
听 和 处 理 。 而 ComponentSystemEventListener 与 SystemEventListener 之 间 不 存在 子 类 与 
超 类 的 关系 ,所 以 一 个 组 件 系统 事件 监听 器 不 能 被 看 作 是 一 个 普通 的 系统 事件 监听 器 ,不 能 
用 于 监听 和 处 理 普 通 的 系统 事件 。 


8. 5.3 注册 系统 事件 监听 器 


系统 事件 的 事件 源 可 以 是 某 种 任意 类 型 对 象 ,Application 对 象 的 subscribeToEvent 方 
法 用 以 注册 一 个 系统 事件 监听 器 。 


public void subscribeToEvent (Class<? extends SystemEvent>systemEventClass, 
Class<?>sourceClass, 


SystemEventListener listener) 


其 中 ,第 一 个 参数 指定 注册 的 监听 器 要 监听 的 系统 事件 的 类 型 ;第 二 个 参数 指明 注册 的 
监听 器 要 监听 的 系统 事件 的 事件 源 类 型 ,可 以 取 null; 第 三 个 参数 指定 要 注册 的 系统 事件 
监听 器 。 

组 件 系统 事件 源 于 某 个 UIComponent 组 件 , UIComponent 对 象 的 subscribeToEvent 
方法 用 于 注册 一 个 组 件 系统 事件 监听 器 ,注册 的 监听 器 将 监听 由 该 UIComponent 对 象 引 发 
的 系统 事件 。 


public void subscribeToEvent (Class<? extends SystemEvent>eventClass, 


ComponentSystemEventListener componentListener) 


其 中 ,第 一 个 参数 指定 注册 的 监听 器 要 监听 的 系统 事件 的 类 型 ;第 二 个 参数 指定 要 注册 的 组 
件 系 统 事件 监听 器 。 

与 其 他 类 型 的 事件 监听 器 一 样 ,采用 声明 方式 注册 系统 事件 监听 器 是 一 种 更 为 常用 的 
方法 。 要 注册 一 个 普通 系统 事件 监听 器 ,可 以 在 JSF 配置 文件 中 ,用 嵌 套 于 application 元 
素 的 system-event-listener 子 元 素 进行 声明 。 


<application> 
<system-event-listener> 
<system-event-class>javax.faces.event.PostConstructApplicationEvent 
</system-event-class> 
<system-event-listener-class>listener.MySystemEventListener 
</system-event-listener-class> 
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</system-event-listener> 

</application> 
其 中 ,system-event-class 子 元 素 指 定 被 注册 的 监听 器 要 监听 的 系统 事件 类 的 完整 类 名 ; 
system-event-listener-class 子 元 素 指定 被 注册 的 系统 事件 监听 器 的 类 的 完整 类 名 。 另 外 ， 
可 以 提供 可 选 的 source-class 子 元 素 指明 被 注册 的 监听 器 要 监听 的 系统 事件 的 事件 源 
类 型 。 

在 application 元 素 中 ,可 以 内 入 多 个 system-event-listener 元 素 , 注 册 多 个 系统 事件 监 
听 器 。 

可 以 采用 声明 方式 注册 一 个 独立 的 组 件 系 统 事件 监听 方法 ,具体 做 法 是 : 在 页 面 文件 
中 ,用 嵌 套 于 某 组 件 标 记 的 f:event 子 标记 进行 声明 ,被 注册 的 监听 方法 将 监听 该 组 件 引 发 
的 特定 类 型 的 组 件 系统 事件 。 下 面 标记 在 视图 根 上 注册 一 个 监听 方法 ,用 于 监听 视图 根 引 
发 的 特定 类 型 的 事件 。 

<f:metadata> 


<f:event type="preRenderView" listener="#{myBean.method}"/> 


</f:metadata> 


其 中 ,type 属性 指定 要 监听 的 组 件 系统 事件 类 型 ,可 以 是 事件 类 的 完整 类 名 ,也 可 以 是 它 的 
短 名 (short name) 。 表 8-2 列 出 了 一 些 组 件 系统 事件 类 的 短 名 。 


表 8-2 组 件 系 统 事件 类 的 短 名 


完整 类 名 短 名 
javax. faces. event. PostAddToViewEvent postAddToView 
javax. faces. event. PreValidateEvent preValidate 
javax. faces. event. PostValidateEvent postValidate 
javax. faces. event. PreRenderViewEvent preRenderView 
Javax. faces. event. PreRenderComponentEvent preRenderComponent 


f:event 标记 的 listener 属性 指定 一 个 方法 表达 式 ,作为 独立 的 组 件 系统 事件 监听 方法 。 
当 所 在 的 组 件 引 发 指定 类 型 的 事件 时 ,该 监听 方法 将 被 调用 。 独 立 的 组 件 系统 事件 监听 方 
法 的 方法 签名 应 该 如 下 : 


public void < 方法 名 > (ComponentSystemEvent event) 
或 

public void < 方法 名 > () 

独立 的 组 件 系统 事件 监听 方法 可 以 抛 出 不 受 检查 的 AbortProcessingException 例外 ， 
以 便 通知 JSF 框架 : 该 事件 不 必 做 进一步 的 处 理 , 即 不 需要 再 广播 至 其 他 的 监听 器 。 
8.5.4 系统 事件 应 用 示例 


本 小 节 以 论坛 应 用 的 注册 功能 为 例 , 介 绍 利用 系统 事件 实现 多 组 件 验证 的 方法 ,同时 也 
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介绍 对 一 个 组 件 值 实现 提前 预 验证 的 方法 。 

在 实现 注册 功能 时 , 除 需 确保 相关 输入 项 为 非 空 外 ,还 要 验证 用 户 名 是 否 已 用 以 及 两 次 
输入 的 密码 是 否 一 致 。 在 之 前 的 论坛 应 用 实现 中 ,后 面 两 项 验证 任务 都 是 在 动作 方法 中 完 
成 的 。 现 在 ,希望 把 这 些 验 证 工作 提前 到 “处 理 验证 ”阶段 ,甚至 “应 用 请 求 值 ” 阶 段 进行 。 

验证 用 户 两 次 输入 的 密码 是 否 相同 的 处 理 逻 辑 是 非常 简单 的 ,但 常规 的 验证 器 却 无 法 
实现 这 一 功能 。 因 为 每 一 个 验证 器 只 能 对 某 一 组 件 的 值 进行 验证 处 理 , 而 不 能 对 多 个 组 件 
的 值 进行 综合 验证 。 利 用 组 件 系 统 事件 postValidate 及 相应 的 监听 方法 ,可 以 较 好 地 克服 
普通 验证 器 的 上 述 限 制 。 

即时 验证 用 户 名 是 否 合法 ,而 不 是 等 所 有 的 输入 项 都 输入 后 青 一 起 验证 ,是 一 种 好 的 做 
法 。 这 里 采用 的 技术 与 8. 4. 3 小 节 中 针对 “部 门 名称 ” 组 件 所 使 用 的 技术 基本 类 似 ,即将 组 
件 的 onchange 属性 值 设 置 为 submit() ,使 得 当 用 户 改 变 组 件 值 时 ,就 会 即时 引起 表单 的 提 
交 和 请 求 。 详 细 情 况 后 面 再 介绍 。 

首先 创建 一 个 名 为 ch8_registry 的 JSF 应 用 项 目 , 然 后 从 应 用 项 目 luntan_logandreg 
(在 第 4. 11 节 介 绍 ) 中 复制 所 有 的 JSF 页 面 、 源 包 中 所 有 的 Java 包 和 Java 类 。 虽 然 本 项 目 
只 需要 修改 registry. xhtml 页 面 文件 和 bean. Registry 受 管 bean 类 ,但 包含 其 他 文件 便于 
运行 和 调试 ,比如 在 完成 注册 后 ,可 以 在 主页 中 选择 退出 ,然后 再 通过 登录 页 面 进行 登录 。 
该 应 用 的 运行 效果 如 图 8-5 所 示 。 

轻松 论坛 一 注册 ~ Mozilla Firefox 而 而 
文件 中 编辑 EE) 查看 WW) 历史 人 G) 书签 @) 工具 (TI) 帮助 00 


be ~ 只 ~ [@ http://localhost:8080/chB_registry/faces/registry. xhtm] | 


请 输入 你 的 信息 : 
loubuye 上 #* 用 户 名 已 被 使 用 


| 
六 


ET 


请 选择 ..， ” 辆 | 


图 8-5 ”应 用 ch8_registry 运行 效果 图 


1. 注册 页 面 

修改 后 的 注册 页 面 registry. xhtml 见 代码 清单 8-6 ,其 中 省 略 了 部 分 无 修改 且 无 关 紧 要 
的 代码 。 

实际 上 ,对 页 面 文件 的 修改 有 两 处 。 一 处 是 在 h:form 标记 下 增加 了 一 个 f:event 标 
记 。 该 标记 在 表单 组 件 上 注册 了 一 个 postValidate 事件 监听 方法 。postValidate 是 一 种 组 
件 系统 事件 ,其 监听 方法 一 般 注 册 于 命名 容器 组 件 , 如 表单 组 件 、 表 格 组 件 ,或 者 注册 于 视图 
根 组 件 。 当 该 容器 组 件 中 的 所 有 输入 类 组 件 都 已 完成 验证 处 理 后 ,该 postValidate 组 件 系 
统 事 件 将 引发 ,已 注册 的 监听 方法 将 被 执行 。 可 以 看 出 ,利用 该 事件 机 制 可 以 实现 对 某 容器 
组 件 内 若干 组 件 值 的 综合 验证 。 但 需要 注意 ,postValidate 事件 的 引发 并 不 取决 于 容器 组 
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件 内 各 组 件 是 否 都 分 别 通过 了 验证 。 也 就 是 说 ,不 管 各 组 件 是 否 通过 验证 ,postValidate 事 
件 都 将 引发 。 在 编写 相应 的 事件 处 理 方法 时 , 需 了 解 这 一 特点 。 
男 一 处 是 对 “用 户 名 ”文本 域 标记 的 修改 ,其 中 添加 了 三 个 属性 。 这 三 个 属性 的 设置 都 


不 陌生 : 
。 onchange 一 "submit()" : 一 旦 用 户 修 改组 件 值 ,提交 表单 。 
。 validator 一 …… : 在 组 件 上 注册 一 个 验证 方法 。 


。 immediate 二 "true" : 组 件 值 的 转换 和 验证 发 生 于 “应 用 请 求 值 ”阶段 。 

在 这 里 ,无 论 是 因 用 户 修改 用 户 名 引起 的 表单 提交 和 请 求 , 还 是 因 用 户 单 击 “ 提 交 ” 按 钮 
引起 的 表单 提交 和 请 求 ,JSF 框架 都 会 在 “应 用 请 求 值 ” 阶 段 用 指定 的 验证 方法 对 用 户 名 进 
行 验证 。 但 在 两 种 情况 下 的 处 理 要 求 却 是 不 一 样 的 : 前 者 在 处 理 完 验证 后 返回 源 页 面 , 若 
验证 失败 ,应 显示 相应 的 错误 消息 :后 者 在 处 理 完 验证 后 , 若 验证 失败 , 则 返回 源 页 面 ,显示 
相应 错误 信息 ,车 验证 成 功 , 则 应 继续 JSF 请 求 处 理 生 命 周 期 ,如 进入 “验证 处 理 ” 阶 段 . 对 
其 他 组 件 值 进行 转换 和 验证 处 理 等 。 

代码 清单 8-6 registry. xhtml 

1. <?xml version='1.0' encoding= 'UTF-8' ?> 


2. <!DOCTYPE html PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 
3. "http://www.w3.0org/TR/xhtmll/DTD/xhtmll-transitional.dtd"> 


4. <html xmlns="http://www.w3.0rg/1999/xhtml" 
33 xmlns:h="http://java.sun.com/jsf/html" 
6. xmlns:f="http://java.sun.com/jsf/core"> 
7. <h:head> 
8. <title> 轻 松 论坛 -- 注 册 </title> 
9. </h:head> 
10. <h:body> 
Ls <p> 
5 <h:outputText value= "请 输入 你 的 信息 :"/> 
3 </p> 
14. <h:form id="fi"> 
EE <f:event type="postValidate" listener="#{registry.validatePassword}"/> 
16. 用 记名 
Fy <h:inputText id="username" value="#{registry.client.username}" 
18, required="true" requiredMessage=" 用 户 名 为 必 填 项 " 
19, size="10" maxlength="15" 
20. immediate="true" 
2 validator="#{registry.validateUsername}" 
onchange="submit ()"/>* 
Sas <h:message for="username"/> 
24. <br/> 
25: 密 码 
26. <h:inputSecret id="password" value="#{registry.client.password}" 
2 required="true" requiredMessage=" 密 码 为 必 填 项 " 
28 . size="10" maxlength="15"/>* 
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295 <h:message for="password"/> 


30. <br/> 

31, 确认 密码 

32 . <h:inputSecret id="passwordl" value="#{registry.password1}" 
33. required="true" requiredMessage=" 密 码 为 必 填 项 " 

34. size="10" maxlength="15"/>* 

9s <h:message for="password1"/> 

36. <br/> 

37s oe // 省 略 部 分 代码 

38 . <P> 

39 。 <h:commandButton type="reset" value=" 重 置 "/> 

40 . gnbsp; 

41. gnbsp; 

42. <h:commandButton id="b" value=" 提 交 " action="#{registry.registry}"/> 
43. </p> 

44. </h:form> 

45. </h:body> 

46. </html> 


2. 受 管 bean 

修改 后 的 受 管 bean 类 bean. Registry 见 代码 清单 8-7 ,其 中 添加 了 两 个 方法 、 修 改 了 一 
个 方法 。 添 加 的 validateUsername 方法 是 注册 在 "用户 名 "文本 域 上 的 验证 方法 ,用 于 验证 
用 户 名 是 否 已 被 使 用 。 添 加 的 validatePassword 方法 是 注册 在 表单 组 件 上 的 postValidate 
事件 监听 方法 ,用 于 验证 用 户 两 次 输入 的 密码 是 否 相 同 。 修 改 的 是 registry 方法 ,是 “提交 ” 
按钮 的 动作 方法 。 上 述 验 证 功能 原来 都 是 由 registry 方法 完成 的 ,所 谓 对 registry 方法 的 
修改 就 是 从 中 删除 实现 这 些 验 证 功能 的 代码 。 

validateUsername 方法 首先 对 用 户 名 进行 验证 。 如 果 验 证 失败 , 则 往 消息 队列 添加 一 
个 消息 ,然后 等 到 当前 阶段 (“应 用 请 求 值 ” 阶 段 ) 结 束 时 , 转 入 “呈现 响应 ”阶段 ,呈现 源 页 面 。 
如 果 验 证 成 功 , 则 判断 本 次 请 求 是 否 由 用 户 单 击 “ 提 交 ” 按 钮 引起 ,如 果 不 是 , 则 与 验证 失败 
时 的 情况 类 似 , 转 去 呈现 源 页 面 ;如 果 是 , 则 继续 JSF 请 求 处 理 生命 周期 。 

validatePassword 方法 首先 获得 两 个 密码 组 件 , 然 后 判断 它们 是 否 有 效 , 即 两 个 密码 组 
件 是 否 通 过 了 各 自 的 验证 。 如 果 各 自 都 通过 了 验证 ,表明 它们 是 非 空 的 ,这 时 可 以 获取 经 过 
验证 的 本 地 值 ,并 判断 两 个 值 是 否 相 同 。 如 果 两 个 密码 组 件 并 非 都 有 效 , 则 表明 它们 之 中 至 
少 有 一 个 是 验证 失败 的 (为 空 值 ) ,这 时 就 没有 继续 处 理 的 必要 了 。 

代码 清单 8-7 bean. Registry 


. Package bean; 

. import entity.Client; 

. import javax.faces .application.FacesMessage; 
。 import javax.faces .bean.ManagedBean; 

. import javax.faces .bean.RequestScoped; 

. import javax.faces.component .UIComponent; 


. import javax.faces.component .UIInput; 


op 人 uNp 


. import javax.faces.context .FacesContext; 
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9. import javax.faces .event .Component SystemEvent; 
10. import model1.ClientManager7 


11. import util.ELUtil; 


13. @ManagedBean 

14. @RequestScoped 

15. public class Registry { 

16. private Client client=new Client (); 
17. public Client getClient(){ 


18. return client; 

19. 本 

20. public void setClient (Client client){ 
21. this .client=client7 

22%5 再 

23. private String passwordl; 


24. public String getPasswordl (){ 


25s return passwordl1; 

26. } 

Ss public void setPasswordl1 (String password1){ 

28. this.passwordl=passwordl1; 

29。 } 

30 . 

E public void validateUsername (FacesContext context,UIComponent component,Object value){ 
3 ClientManager cm=new ClientManager (); 

Ek Client clientl=cm.findClientByName ((String)value) 7 

34. if(clientl!=null)t{ 

35。 FacesMessage msg=new FacesMessage (" 用 户 名 已 被 使 用 ") ; 

36. FacesContext .getCurrentInstance () .addMessage (component .getClientId(),msg);{ 
SEs FacesContext .getCurrentInstance () .renderResponse(); 

38。 3 

39, Object ok=util .ELUtil.evalEL("#{param['fi:b']}"); 

40. if(ok==nul11){ 

坟 时 局 FacesContext .getCurrentInstance () .renderResponse(); 

42. } 

43. } 

44. public void validatePassword(ComponentSystemEvent cse){ 

LF UIComponent source=cse.getComponent (); 

46. UIInput pass= (UIInput) source.findComponent ("fi:password"); 

47。 UIInput passl= (UIInput) source.findComponent ("fi:password1"); 

48. if(pass.isValid()&&passl.isValid()){ 

49 . String spass= (String)pass.getLocalValue () 

50， String spassl= (String)passl.getLocalValue () 

Ss if(!spassl.equals (spass)){ 

S52 FacesMessage msg=new FacesMessage ("两 次 输入 的 密码 不 一 致 "); 

$3 FacesContext .getCurrentInstance () .addMessage ("fi:passwordl1",msg); 


FacesContext .getCurrentInstance () .renderResponse () 7 
} 
} 
} 
public String registry(){ // 注 册 * 提 交 ?动作 方法 
ClientManager cm=new ClientManager () 
client.setSstatus('1'); 
boolean f=cm.insertClient (client); 
if(!f){ 
FacesMessage msg=new FacesMessage ("注册 出 错 "); 
FacesContext .getCurrentInstance () .addMessage ("fi:username",msg); 
return null; 
} 
SessionInfo sessinfo= (SessionInfo)ELUtil.getBean ("sessinfo"); 
sessinfo.setClient (client); 


return "index"; 


8.6 小 结 


JSF 事件 包括 Faces 事件 、 阶 段 事 件 和 系统 事件 三 大 类 ,Faces 事件 又 分 动作 事件 和 
值 变 化 事件 两 种 。 

动作 事件 (ActionEvent) 的 事件 源 是 动作 类 组 件 ,其 监听 器 接口 是 ActionListener。 
值 变 化 事件 (ValueChangeEvent) 的 事件 源 包括 基本 输入 类 组 件 、 选 择 类 组 件 和 视图 
参数 组 件 等 ,其 监听 器 接口 是 ValueChangeListener。 

阶段 事件 (PhaseEvent) 的 事件 源 是 Lifecycle 对 象 ,其 监听 器 接口 是 PhaseListener。 
系统 事件 (SystemEvent) 是 一 类 事件 的 总 称 。 一 种 系统 事件 的 事件 源 可 以 是 某 种 任 
意 类 型 对 象 。 任 何 一 种 系统 事件 的 监听 器 接口 都 是 SystemEventListener。 

组 件 系统 事件 (ComponentSystemEvent) 是 系统 事件 的 子 类 型 ,也 是 一 类 事件 的 总 
称 。 一 种 组 件 系 统 事 件 的 事件 源 可 以 是 某 种 UIComponent 型 对 象 。 任 何 一 种 组 件 
系统 事件 的 监听 器 接口 都 是 ComponentSystemEventListener。 

事件 监听 器 在 能 够 监听 事件 之 前 ,必须 先进 行 注册 。 各 种 事件 监听 器 有 相应 的 注册 
方法 。 


习 题 8 


和 件 源 ; 
友人 件 对 象 ; 
有 件 监听 器 。 


je 
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2. 动作 事件 是 如 何 产生 的 ? 一 个 动作 事件 是 否 可 以 有 多 个 监听 器 或 监听 方法 ? 这 些 
监听 器 和 监听 方法 按 何 种 顺序 被 通告 或 调用 ? 
3. 如 何 定义 值 变化 监听 器 类 ? 如 何 注册 一 个 值 变化 监听 器 ? 
4. 如 何 定义 阶段 监听 器 类 ? 如 何 注册 阶段 监听 器 ? 
5. 简 述 注册 系统 事件 监听 器 和 组 件 系 统 事件 监听 器 的 方法 。 
6. 比较 值 变化 事件 与 postValidate 组 件 系统 事件 发 生 的 条 件 、 时 间 。 

7. 修改 应 用 项 目 sh4_logandreg( 第 4 章 第 5 题 ) 中 的 注册 功能 : 能 对 用 户 名 进行 提前 
预 验证 ;能 在 “处 理 验 证 ?阶段 结束 前 ,对 用 户 两 次 输入 的 密码 的 一 致 性 进行 验证 。 
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第 9 章 资源 包 与 国际 化 


本 章 主 题 : 

。 创建 资源 包 

。 资源 包 类 与 属性 文件 
。 在 JSF 中 使 用 资源 包 
。 场所 (Locale) 

。 国际 化 


资源 包 (Resource Bundle) 是 Java 标准 版 提供 的 特性 ,并 在 Java 企业 版 中 得 到 进一步 
的 支持 。 在 JSF 中 使 用 资源 包 还 有 其 自己 的 特点 ,如 通过 注册 声明 后 就 可 以 在 EL 值 表达 
式 中 直接 访问 资源 包 ,而 不 需要 用 代码 显 式 创建 或 获取 资源 包 。 

支持 应 用 软件 国际 化 是 资源 包 固 有 的 功能 。 在 JSF 应 用 中 ,通过 使 用 资源 包 和 消息 
包 , 不 仅 可 以 将 JSF 应 用 中 各 页 面 的 静态 文本 等 从 页 面 中 分 离 出 来 ,使 它们 能 被 集中 管理 
和 重用 ,而且 可 使 JSF 应 用 能 够 向 来 自 不 同 国家 、 使 用 不 同 语言 的 用 户 呈现 符合 他 们 阅读 
习惯 的 响应 。 


9.1 创建 资源 包 


资源 包 是 ResourceBundle 抽象 类 的 某 个 具体 子 类 的 实例 ,由 一 组 键 一 值 对 组 成 。 键 总 
是 字符 串 ( 区 分 大 小 写 ) , 值 可 以 是 任意 类 型 的 对 象 。 在 很 多 情况 下 , 值 也 是 字符 串 。 

ResourceBundle 抽象 类 的 某 个 具体 子 类 也 称 为 资源 包 类 。 要 创建 资源 包 , 一 般 应 先 定 
义 资源 包 类 ,然后 再 用 特殊 的 方法 创建 或 获取 资源 包 。 


9.1.1 扩展 ResourceBundle 类 


可 以 扩展 ResourceBundle 抽象 类 ,定义 资源 包 类 。ResourceBundle 的 具体 子 类 必须 覆 
盖 以 下 两 个 抽象 方法 : 

(1) protected Object handleGetObject(String key) 

返回 当前 资源 包 中 指定 键 的 资源 。 若 不 存在 相应 的 资源 ,返回 null。 

(2) public Enumeration<String> getKeys() 

返回 前 资源 包 中 所 有 资源 的 键 的 枚 举 对 象 。 

BundleOne 是 一 个 简单 的 ResourceBundle 具体 子 类 的 示例 。 它 包含 了 三 个 String 型 
的 资源 ,其 中 第 3 个 资源 是 一 个 包含 参数 的 消息 模板 ,所 有 资源 保存 在 一 个 Map 对 象 中 。 
见 代 码 清单 9-1。 

代码 清单 9-1 资源 包 类 bundle. BundleOne 


1. package bundle; 
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. import java.util.Collections; 
. import java.util.Enumeration; 


. import java.util.HashMap; 


2 

3 

4 

5. import java.util.Map; 

6. import java.util.ResourceBundle; 
7 
8 


. Public class BundleOne extends ResourceBundlef{ 


9. private Map<String,String>resources=new HashMap<String,String> (); 
10. public Bundleone (){ 
和 resources.put ("prompt", "请 输入 :"); 
Rs resources.put ("button title", "确认 "); 
33， resources.put ("result", "你 输入 的 值 是 :{01") 
14. } 上】 


15. override 

16. protected Object handleGetObject (String key){ 
Es return resources.get (key); 

18, } 

19.  Q@Override 

20. Public Enumeration<String>getKeys ()1{ 


21s return Collections.enumeration (resources.keySet ()); 


9.1.2 扩展 ListResourceBundle 类 


定义 资源 包 类 的 一 种 更 为 方便 的 方法 是 扩展 ListResourceBundle 类 ,定义 一 个 具体 的 
子 类 。ListResourceBundle 是 ResourceBundle 类 的 抽象 子 类 。ListResourceBundle 的 具体 
子 类 必须 覆盖 以 下 抽象 方法 : 


protected Object[] [] getContents () 


该 方法 返回 当前 资源 包 中 所 有 资源 的 键 一 值 对 。 方 法 返回 一 个 Object[][] 型 对 象 ,其 中 每 
一 个 内 层 数组 由 两 个 元 素 组 成 ,第 1 个 元 素 表 示 一 个 资源 的 键 , 必 须 是 字符 串 , 第 2 个 元 素 
表示 该 资源 的 值 。 

BundleTwo 是 一 个 简单 的 ListResourceBundle 具体 子 类 的 示例 。 它 定义 了 与 
BundleOne 类 一 样 的 资源 。 见 代码 清单 9-2。 

代码 清单 9-2 资源 包 类 bundle. BundleTwo 


. Package bundle; 


. import java.util.ListResourceBundle; 


1 

2 

3 

4. public class BundleTwo extends ListResourceBundle { 
5. Q@Override 

6 protected Object [] [] getContents(){ 

了 return new Object[][] { 

8 {"prompt", "请 输入 :"}， 
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9. {"button title", "确认 "}， 
10. {"result", "你 输入 的 值 是 :{0}"} }; 
LS 3 
| 


9.1.3 资源 包 的 获取 与 使 用 


资源 包 是 资源 包 类 的 实例 ,但 资源 包 并 不 是 简单 地 利用 new 表达 式 来 创建 的 ,而 是 通 
过 调用 ResourceBundle 类 的 getBundle 方法 来 创建 或 获取 。 

getBundle 是 ResourceBundle 类 中 定义 的 一 组 重 载 的 静态 方法 ,用 于 创建 或 获取 一 个 
指定 的 资源 包 。 下 面 是 getBundle 方法 的 一 种 基本 格式 : 


public static final ResourceBundle getBundle (String baseName) 


该 方法 创建 指定 基 名 的 资源 包 , 基 名 是 相应 资源 包 类 的 完整 类 名 。 上 默认 情况 下 ,创建 的 资源 
包 将 被 缓存 ,下 次 再 调用 该 方法 时 将 直接 返回 已 存在 的 资源 包 。 若 不 存在 指定 的 资源 包 , 方 
法 抛 出 不 受 检查 的 java. util. MissingResourceException 例外 。 

一 旦 获得 了 资源 包 , 就 可 以 通过 下 面 方法 获取 资源 包 中 指定 键 的 资源 。 


Public final Object getObject (String key) 
如 果 能 确保 资源 是 String 型 的 ,那么 也 可 以 用 下 面 方法 获取 指定 键 的 资源 。 
public final String getString(String key) 


与 getBundle 方法 类 似 , 对 于 getObject 或 getString 方法 ,如 果 当 前 资源 包 中 不 存在 指 
定 键 的 资源 ,那么 也 会 抛 出 MissingResourceException 例外 。 

第 4.4 节 曾 介绍 如 何 用 h:outputFormat 和 f:param 标记 在 JSF 页 面 中 参数 化 和 显示 
一 个 消息 模板 。 在 Java 代码 中 , 则 可 以 利用 java. text. MessageFormat 类 的 format 静态 方 
法 实现 消息 模板 的 参数 化 。 


public static String format (String pattern,Object... arguments) 


其 中 ,方法 的 第 1 个 参数 指定 消息 模板 ,后 面 可 以 根据 消息 模板 中 的 参数 数目 指定 相应 数目 
的 参数 值 。 

代码 清单 9-3 是 一 个 Java 应 用 程序 ,演示 了 如何 获取 资源 包 和 使 用 资源 包 。 程 序 首先 
获取 基 名 为 bundle. BundleOne 的 资源 包 , 然 后 输出 了 该 资源 包 中 所 有 资源 的 键 和 值 , 最 后 
参数 化 并 输出 键 为 result 的 消息 模板 资源 。 

代码 清单 9-3 资源 包 的 获取 与 使 用 


1. import java.text.MessageFormat; 

2. import java.util.Enumeration; 

3. import java.util.ResourceBundle; 

4. 

5. public class BundleDemo { 

6. Ppublic static void main(String[] args){ 


Pe ResourceBundle rb=ResourceBundle.getBundle ("bundle.BundleOne"); 
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8 . Enumeration<String>keys=rb.getKeys () 7 


: while (keys.hasMoreElements ()){ 
10 . String key=keys .nextElement () 
ls System.out .println(key+":"+rb.getString(key) ) 7 
12， } 
人 String r result=rb.getstring("result"); 
于 String msg=MessageFormat.format (r result,"China"); 
15。 System.out .Println(msg) 7 
16. } 
Ey 
下 面 是 程序 的 运行 结果 : 


result: 你 输入 的 值 是 :{0} 
prompt :请 输入 : 

button title: 确 认 

你 输入 的 值 是 :china 


说 明 : 资源 包 类 、 资 源 包 与 普通 的 类 、 对 象 相 比 有 明显 的 不 同 ,基于 某 个 资源 包 类 创建 
的 各 资源 包 对 象 总 是 具有 相同 的 资源 ,这 些 资源 定义 在 资源 包 类 中 。 所 以 有 时 也 把 资源 包 
类 直接 称 为 资源 包 。 


9.1.4 PropertyResourceBundle 类 与 属性 文件 


如 果 一 个 资源 包 的 资源 都 是 字符 串 文本 或 消息 模板 ,那么 也 可 以 把 它们 定义 在 一 个 属 
性 文件 中 。 属 性 文件 是 一 个 扩展 名 为 . properties 的 文本 文件 ,包含 一 系列 属性 定义 。 在 属 
性 文件 中 ,每 个 属性 定义 占 一 行 ,包括 属性 名 和 属性 值 。 


< 属性 名 >=< 属 性 值 > 


当 把 一 个 属性 文件 看 作 是 一 个 资源 集 时 ,文件 中 的 每 个 属性 就 是 资源 包 中 的 一 个 资源 。 
其 中 ,属性 名 是 资源 的 键 ,属性 值 就 是 资源 的 值 。 属 性 文件 BundleThree. properties 定义 了 
与 资源 包 类 BundleOne 和 BundleTwo 一 样 的 资源 , 见 代 码 清单 9-4。 

代码 清单 9-4 属性 文件 bundle/BundleThree. properties 

1. prompt= 请 输入 : 

2. button title= 确 认 

3. result= 你 输入 的 值 是 : {0} 

从 用 户 的 角度 来 看 ,属性 文件 的 作用 类 似 于 资源 包 类 。 属 性 文件 应 该 与 资源 包 类 存放 
在 相同 的 位 置 , 比如 属性 文件 BundleThree. properties 与 资源 包 类 BundleOne 和 
BundleTwo 都 存放 在 bundle 目录 下 。 利 用 ResourceBundle 类 的 getBundle 静态 方法 同样 
可 以 基于 属性 文件 创建 或 获取 一 个 资源 包 。 下 面 代码 通过 指定 属性 文件 BundleThree. 
properties 创建 或 获取 相应 的 资源 包 : 


ResourceBundle rb=ResourceBundle.getBundle ("bundle.BundleThree"); 


getBundle 方法 执行 时 ,首先 会 查看 在 缓存 中 是 否 已 有 指定 的 资源 包 。 若 存在 相应 的 
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资源 包 ,那么 直接 返回 即 可 。 若 不 存在 相应 的 资源 包 , 则 查找 是 否 存在 指定 的 资源 包 类 。 若 
存在 相应 的 资源 包 类 , 则 实例 化 、 缓 存 并 返回 。 如 果 不 存在 资源 包 类 , 则 查找 是 否 存 在 相应 
的 属性 文件 ( 基 名 中 的 “. ”用 */” 替 换 , 并 加 扩展 名 . properties) 。 若 存在 相应 的 属性 文件 , 则 
创建 资源 包 类 PropertyResourceBundle 的 一 个 实例 ,并 与 相应 的 属性 文件 建立 关联 ,然后 
缓存 .返回 该 资源 包 实例 。 

PropertyResourceBundle 是 ResourceBundle 类 的 一 个 具体 子 类 。 与 其 他 资源 包 类 不 
同 ,该 资源 包 类 本 身 并 没有 定义 任何 资源 。 在 创建 PropertyResourceBundle 型 资源 包 实 例 
时 ,需要 将 其 与 某 个 属性 文件 建立 关联 , 它 把 属性 文件 的 内 容 当 作 自 己 所 管理 的 资源 。 

说 明 : 由 于 基于 某 个 属性 文件 创建 的 各 PropertyResourceBundle 型 资源 包 实 例 都 具有 
相同 的 资源 ,这 些 资源 定义 在 属性 文件 中 ,所 以 有 时 也 把 这 些 包 含 资源 的 属性 文件 直接 称 为 
资源 包 。 


9.2 在 JSF 中 使 用 资源 包 


JSF 提供 对 Java 资源 包 的 支持 。 在 JSF 中 ,可 以 通过 声明 的 方式 创建 资源 包 , 然 后 利 
用 EL 表达 式 访 问 资源 。 消 息 包 是 一 种 特殊 的 资源 包 , 在 JSF 中 起 着 重要 的 作用 ,本 节 也 将 
作 详 细 介绍 。 


9.2.1 资源 包 的 注册 、 装 入 与 使 用 


在 JSF 应 用 中 ,要 使 用 资源 包 , 同 样 需要 先 定义 资源 包 类 或 属性 文件 。 这 些 资 源 包 类 
或 属性 文件 通常 定义 于 源 包 。 比 如 ,可 以 将 资源 包 类 BundleOne. java、BundleTwo. java 和 
属性 文件 BundleThree. properties 都 存放 在 源 包 的 bundle 包 或 目录 中 。 

在 JSF 应 用 中 ,一 般 不 需要 通过 ResourceBundle 类 的 getBundle 方法 显 式 创建 或 获取 
资源 包 , 而 只 需 通 过 声明 告诉 JSF 框架 该 应 用 或 该 页 面 需 要 使 用 什么 类 型 的 资源 包 ,JSF 框 
架 会 在 需要 时 自动 创建 相应 的 资源 包 并 进行 管理 和 维护 。 

可 以 在 Faces 配置 文件 中 用 resource-bundle 元 素 进 行 声明 ,其 中 base-name 子 元 素 指 
定 资源 包 的 基 名 ,var 子 元 素 暴 露 资源 包 实 例 的 名 称 。 

代码 清单 9-5 注册 了 一 个 基 名 为 bundle. BundleOne 的 资源 包 。 在 当前 应 用 的 EL 值 
表达 式 中 ,可 以 通过 var 子 元 素 暴 露 的 名 称 rbl 访问 该 资源 包 中 的 资源 ,如 并 {rbl. 
prompt ) 。 


代码 清单 9-5 ”注册 资源 包 


1. <application> 


0 <resource-bundle> 

3 <base-name>bundle.BundleOne</base-name> 
4. <var>rbl</var> 

5 </resource-bundle> 


Gy spe0e 

7. </application> 

这 种 声明 的 方式 也 称 为 注册 资源 包 。 通 过 这 种 方式 注册 的 资源 包 只 实例 化 一 次 ,在 各 
“ 209 


页 面 中 都 可 被 使 用 。 

也 可 以 在 JSF 页 面 中 用 f:loadBundle 标记 进行 声明 ,其 中 basename 属性 指定 资源 包 
的 基 名 ,var 属性 暴露 资源 包 的 名 称 。 

下 面 标记 可 以 放 在 JSF 页 面 中 ,用 于 装 人 了 一 个 基 名 为 bundle. BundleThree 的 资源 
包 , 即 基于 属性 文件 bundle/BundleThree. properties 的 资源 包 。 在 当前 页 面 的 EL 值 表达 
式 中 ,可 以 通过 var 属性 暴露 的 名 称 rb3 访问 该 资源 包 中 的 资源 ,如 #{rb3.button_title) 。 


<f:loadBundle basename="bundle.BundleThree" var="rb3"/> 


这 种 声明 的 方式 也 称 为 装 和 人 资源 包 。 通 过 这 种 方式 装 和 的 资源 包 只 能 在 当前 页 面 被 使 用 ， 


0 围 的 。 
显而易见 ,注册 资源 包 比 装 人 资源 包 更 为 有 效 , 因 为 每 个 注册 资源 包 在 整个 应 用 作用 域 
内 只 需 创 建 一 


在 一 个 JSF 应 用 中 ,可 以 注册 或 装 入 多 个 资源 包 ,每 个 资源 包 可 以 通过 var 子 元 素 或 属 
性 暴露 的 资源 包 名 称 进 行 访问 。 


9.2.2 资源 包 应 用 示例 
该 应 用 项 目 (ch9_bundle) 演 示 资 源 包 的 应 用 ,主要 由 一 个 资源 包 类 .一 个 受 管 bean 和 
一 个 JSF 页 面 组 成 。JSF 页 面 的 呈现 效果 如 图 9-1 所 示 。 


文件 FE) 编辑 E) 查看 WwW) 历史 G) 书签 @) I 具名 帮助 0 他 


-|B Mt /ocahost:e000/che bundle/faces/index xhtnl | 
请 输入 : 


| 
你 输入 的 值 是 :China 


图 9-1 应 用 ch9_bundle( 使 用 资源 包 ) 


1. 资源 包 

首先 在 应 用 项 目的 源 包 下 创建 一 个 名 为 bundle 的 Java 包 , 并 在 该 包 中 创建 资源 包 类 
BundleOne. java, 具 体 代 码 见 代码 清单 9-1 。 

然后 再 为 应 用 项 目 在 WEB-INF 下 创建 Faces 配置 文件 faces-config. xml, 并 在 其 中 注 
册 上 述 资源 包 。 具 体 代码 见 代码 清单 9-5。 

2. 受 管 bean 

该 应 用 包含 一 个 受 管 bean, 文 件 名 为 Index. java( 代 码 清单 9-6) 。 其 中 定义 了 一 个 可 读 
写 的 String 型 的 属性 value。 

代码 清单 9-6” 受 管 bean(Index. java) 


1. package bean; 
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. import javax.faces .bean.ManagedBean; 


. import javax.faces .bean.RequestSscoped; 


4 

3 

4 

5. @ManagedBean 
6. QRequestScoped 

7. public class Index { 

8 private String value=""; 


9. public String getValue (){ 


10. return value; 

11s 

12. public void setValue (String value){ 
时 this.value=value; 

14. } 

15s } 

3. JSF 页 面 


代码 清单 9-7 给 出 的 JSF 页 面 演示 了 资源 包 的 使 用 。 其 中 文本 域 的 标签 ,递交 按钮 的 
标题 以 及 按钮 下 方 的 响应 文本 都 来 自 资源 包 。 
代码 清单 9-7 JSF 页 面 (index. xhtml) 


,<?xml version='1.0' encoding= 'UTF-8' ?> 

.<“!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 

.<html xmlns="http://www.w3.0rg/1999/xhtml" 


于 

2 

3 

4 

-全 xmlns:h="http://java.sun.com/jsf/html" 
6 xmlns:f="http://java.sun.com/jsf/core"> 
浊 <h:head> 

8 <title>ResourceBundleDemo</title> 

9. </h:head> 


10. <h:body> 


YL <h:form id="f"> 

六 全 二 <p><h:outputLabel for="i" value="#{rbl.prompt}"/></p> 
Ek <p><h:inputText id="i" value="#{index.value}"/></p> 
ds <p><h:commandButton value="#{rbl.button title}"/></p> 
15。 </h:form> 

16. <p> 

7 <h:outputFormat value="#{rbl.result}"> 

18. <f:param value="#{index.value}"/> 

19. </h:outputFormat> 

20. </p> 


21. </h:body> 
22. </html> 


息 包 及 其 使 用 


消息 包 是 资源 包 特 性 在 JSF 中 的 另 一 个 具体 应 用 。 在 JSF 中 , 当 转 换 或 验证 出 错时 ， 
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应 产生 一 个 FacesMessage 消息 .并 抛 出 例外 ,这 些 消 息 会 被 自动 放 和 人 消息 队列 。 另 外 ,在 处 
理 各 类 事件 时 ,也 可 以 产生 FacesMessage 消息 ,并 将 其 放 入 消息 队列 。 当 页 面 再 次 呈现 时 ， 
消息 队列 中 的 消息 将 通过 h:message 或 h:messages 组 件 被 显示 出 来 。 

一 个 FacesMessage 消息 由 概要 文本 、 详 细 文 本 和 严重 级 别 三 部 分 组 成 。 其 中 概要 文本 
和 详细 文本 可 以 由 消息 包 管理 。 消 息 包 是 一 种 特殊 的 资源 包 , 其 中 每 一 个 资源 的 键 称 为 消 
息 ID ,每 一 个 资源 的 值 总 是 String 型 的 , 称 为 消息 文本 (包括 消息 模板 ) 。 由 于 一 个 消息 既 
有 概要 文本 ,又 有 详细 文本 ,所 以 一 个 消息 可 能 包括 两 个 资源 ,一 个 指定 消息 的 概要 文本 ,一 
个 指定 消息 的 详细 文本 。 这 里 ,指定 详细 文本 的 消息 ID 总 是 以 detail 结尾 ,而 其 前 面部 分 
则 与 相应 的 指定 概要 文本 的 消息 ID 相同 。 

与 一 般 的 资源 包 一 样 ,消息 包 也 应 该 基于 资源 包 类 或 者 基于 属性 文件 来 创建 。 由 于 消 
息 资源 总 是 String 型 的 ,所 以 更 多 的 是 采用 属性 文件 的 形式 。 下 面 是 用 作 消息 包 的 属性 文 
件 的 内 容 的 一 般 格式 : 


msgl=… 


msgl_detail=…{0}]… 

这 里 仅 定义 了 一 个 消息 的 概要 文本 和 详细 文本 ,其 中 详细 文本 包含 一 个 参数 。 一 般 来 
说 ,无 论 是 概要 文本 还 是 详细 文本 ,都 可 以 是 普通 的 消息 文本 ,也 可 以 是 带 参数 的 消息 模板 。 

在 NetBeans IDE 中 ,创建 一 个 属性 文件 的 一 般 步骤 如 下 (在 “项 目 ” 窗 口中 进行 ): 

(1) 单 击 选择 项 目 结 点 。 

(2) 从 “文件 ”菜单 ,选择 “新 建文 件 " 命 令 , 打 开 “ 新 建文 件 ” 对 话 框 。 

(3) 选择 文件 类 型 : 其 他 | 属性 文件 。 

(4) 指定 文件 名 (不 需要 指定 扩展 名 ), 并 指定 存放 属性 文件 的 文件 夹 。 

(5) 单 击 “ 完 成 "按钮 。 

要 使 用 消息 包 , 首 先 需 要 在 Faces 配置 文件 中 用 message-bundle 元 素 进行 声明 和 注册 ， 
其 中 message-bundle 元 素 是 application 元 素 的 子 元 素 , 用 于 指定 消息 包 的 基 名 。 


<message-bundle>…</message-bundle> 


与 一 般 的 资源 包 不 同 , 一 个 JSF 应 用 只 能 注册 一 个 消息 包 , 该 消息 包 称 为 由 用 户 提供 
的 自 定义 消息 包 。 相 对 应 的 ,框架 本 身 包含 的 消息 包 ( 基 名 为 javax. faces. Messages) 则 称 
为 由 应 用 提供 的 标准 消息 包 。 
注册 了 消息 包 ,就 可 以 访问 消息 包 ,获取 其 中 的 消息 文本 ,进而 创建 消息 对 象 。 下 面 介 
绍 使 用 消息 包 的 一 般 过 程 和 方法 。 

(1) 获取 消息 包 的 基 名 

调用 Application 对 象 的 getMessageBundle 方法 可 以 返回 应 用 中 用 户 提 供 的 自 定义 消 
息 包 的 基 名 。 


FacesContext context=""; 
Application app=context .getApplication (); 


String baseName=app .getMessageBundle(); 


一 些 转 换 器 、 验 证 器 需要 被 设计 成 是 可 重用 的 ,这 时 把 消息 包 的 基 名 硬 编码 到 代码 中 是 
“B12 = 


不 行 的 。 如 果 用 户 在 应 用 中 没有 注册 消息 包 ,那么 getMessageBundle 方 法 返回 null。 

(2) 根据 基 名 获取 消息 包 

消息 包 也 是 资源 包 , 可 以 调用 ResourceBundle 类 的 getBundle 获取 消息 包 。 若 不 存在 
指定 的 消息 包 ,getBundle 方 法 将 抛 出 MissingResourceException 例外 。 


ResourceBundle mb=ResourceBundle.getBundle (baseName); 


(3) 根据 消息 ID 获取 消息 文本 

与 从 资源 包 中 获取 资源 一 样 ,可 以 调用 消息 包 的 getString 方法 获取 指定 消息 ID 的 消 
息 文本 。 若 不 存在 指定 的 消息 文本 , getString 方法 将 抛 出 MissingResourceException 
例外 。 


String mid="msgl"7 
String summary=mb .getString (mid); 
String detail=mb.getString (mid+" detail"); 


(4) 参数 化 消息 模板 
如 果 消 息 文 本 是 消息 模板 , 则 可 以 调用 MessageFormat 类 的 format 方法 对 消息 模板 进 
行 格式 化 操作 ,产生 参数 化 的 消息 文本 。 


Object value=… // 参 数 


detail=MessageFormat .format (detail,value); 
(5) 创建 消息 对 象 
利用 消息 文本 创建 FacesMessage 类 的 实例 ,并 指定 消息 的 严重 级 别 。 


FacesMessage fmsg=new FacesMessage (summary, detail); 
fmsg.setSeverity (FacesMessage.SEVERITY ERROR); 


(6) 将 消息 对 象 加 入 消息 队列 

在 请 求 处 理 过 程 中 ,如 果 出 现 例 外 情况 ,应 该 将 产生 的 消息 对 象 放 入 消息 队列 ,以 便 在 
页 面 重新 呈现 时 能 显示 出 这 些 错误 消息 。 

对 于 转换 器 或 验证 器 ,在 处 理 过 程 中 如 果 出 现 例 外 情况 .应 该 以 产生 的 消息 对 象 为 参数 
创建 相应 的 例外 对 象 并 抛 出 。 这 样 ,消息 对 象 会 被 自动 放 入 消息 队列 。 

在 处 理 各 类 事件 时 ,如 果 出 现 例外 情况 ,可 以 调用 FacesContext 型 对 象 的 addMessage 
方法 将 消息 对 象 加 入 消息 队列 。 


FacesContext Context=… 


context.addMessage ("f:i",fmsg); 


其 中 ,第 1 个 参数 指定 某 组 件 的 客户 端 人 D, 作 为 该 消息 的 源 。 若 该 参数 为 null, 表 明 添 加 的 
是 一 个 全 局 消息 。 第 2 个 参数 指定 一 个 FacesMessage 对 象 。 
在 上 述 一 系列 步骤 中 ,(1) 至 (5) 步 的 功能 实质 上 是 利用 消息 ID 和 格式 化 消息 模板 所 需 
的 参数 创建 一 个 FacesMessage 对 象 。 虽 然 JSF 规范 没有 提供 相应 的 编程 接口 ,但 其 参考 实 
现 却 包含 一 个 能 完成 此 功能 的 方法 , 即 MessageFactory 类 的 getMessage 方法。 在 有 些 场 
合 可 以 考虑 使 用 该 方法 来 直接 创建 FacesMessage 对 象 。 
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public static FacesMessage getMessage (String messagelId,Object... params); 


其 中 MessageFactory 类 定义 于 com. sun. faces. util 包 。 
9.2.4 ”替换 标准 消息 文本 


第 7 章 的 表 7-3 和 表 7-6 列 出 了 一 些 常 用 的 标准 转换 消息 和 验证 消息 ,这 些 消息 文本 都 
定义 在 JSF 框架 提供 的 标准 消息 包 javax. faces. Messages 中 。 当 出 现 异常 情况 时 ,标准 转 
换 器 和 验证 器 通常 利用 这 些 消息 文本 创建 FacesMessage 对 象 并 抛 出 例外 。 

可 以 由 用 户 自 定义 的 消息 文本 替换 标准 的 消息 文本 ,使 得 标准 转换 器 和 验证 器 能 根据 
这 些 自 定 义 的 消息 文本 来 创建 消息 对 象 。 蔡 换 标 准 消息 文本 ,通常 并 不 是 指 修改 标准 消息 
包 中 的 相关 消息 文本 ,而 是 指 在 自 定义 消息 包 中 定义 与 某 标准 消息 具有 相同 消息 ID 的 消息 
文本 。 当 出 现 异 常情 况 时 ,标准 转换 器 和 验证 器 会 先 从 自 定义 消息 包 中 寻找 具有 指定 消息 
ID 的 消息 文本 。 如 果 在 自 定义 消息 包 中 找 不 到 所 需 的 消息 文本 ,再 从 标准 消息 包 中 寻找 具 
有 指定 消息 ID 的 消息 文本 。 然 后 利用 消息 文本 创建 消息 对 象 。 

在 JSF 规范 的 参考 实现 中 ,标准 转换 器 和 验证 器 实际 上 都 是 调用 MessageFactory 类 的 
getMessage 方法 来 完成 上 述 功能 的 。 也 就 是 说 ,getMessage 方法 会 依次 从 自 定义 消息 包 、 
标准 消息 包 寻 找 指定 消息 ID 的 消息 文本 ,然后 创建 一 个 FacesMessage 对 象 返回 。 

9%.2.5 消息 包 应 用 示例 

该 示例 继续 9. 2. 2 节 介 绍 的 应 用 项 目 (ch9_bundle) ,用 于 演示 消息 包 的 使 用 。 在 项 目 
中 增加 了 一 个 消息 包 、 一 个 自 定义 验证 器 和 一 个 JSF 页 面 。JSF 页 面 的 呈现 效果 如 图 9-2 
所 示 ,其 中 : (a) 显 示 了 标准 验证 器 根据 自 定义 消息 文本 产生 的 错误 消息 ,(b) 显 示 了 自 定义 
验证 器 产生 的 错误 消息 。 


) 查看 W) 历史 GE) 书签 @) 工具 GD) 帮助 0) 如 | 


-| 口 mep://leeahert:B080/ehe_bundlwyfaces/indexl_xhte| =] 天] 


息 含 非 字母 字符 : we2me 


你 输入 的 值 是 : 


完成 


图 9-2 应 用 ch9_bundle( 使 用 消息 包 ) 


1. 消息 包 

首先 在 bundle 包 下 创建 属性 文件 mymsg. properties, 见 代码 清单 9-8。 其 中 定义 了 一 
个 消息 (消息 ID 为 msgl) 的 概要 文本 和 详细 文本 。 另 外 重新 定义 了 一 个 标准 验证 消息 文 
本 ,该 消息 文本 会 被 标准 验证 器 LengthValidator 使 用 。 

代码 清单 9-8 属性 文件 (mymsg. properties) 

1. msg1= 包 含 非 字母 字符 

2. msgl detail= 包 含 非 字 母 字 符 : {0} 
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3. javax.faces.validator.LengthValidator.MINIMUM= 长 度 必 须 大 于 等 于 :{0} 


然后 在 Faces 配置 文件 faces-config. xml 中 注册 该 消息 包 , 见 代码 清单 9-9 。 
代码 清单 9-9 注册 消息 包 


1. <application> 

2 <message-bundle>bundle.mymsg< /message-bundle> 
Be ds 
4 


. </application> 


2. 自 定义 验证 器 

首先 在 应 用 项 目的 源 包 下 创建 一 个 Java 包 validator, 然 后 在 该 包 中 创建 一 个 自 定 义 验 
证 器 类 MyValidator. java( 代 码 清单 9-10) 。 该 验证 器 用 于 验证 用 户 从 文本 域 中 输入 的 字符 
串 是 否 仅 包含 字母 。 如 果 包 含 非 字母 字符 ,验证 器 将 从 消息 包 中 获取 相应 的 消息 文本 ,然后 
创建 FacesMessage 对 象 ,并 抛 出 例外 。 

代码 清单 9-10 自 定义 验证 器 类 (MyValidator. java) 


. Package validator; 

. import java.text.MessageFormat; 

. import java.util.MissingResourceException; 

. import java.util.ResourceBundle; 

. import javax.faces .application.Application; 

. import javax.faces .application.FacesMessage; 


. import javax.faces.component .UIComponent; 


oamumwewnb PP 


. import javax.faces.context.FacesContext; 
9. import javax.faces .validator.FacesValidator; 
10. import javax.faces .validator.Validator; 


11. import javax.faces.validator.ValidatorException; 


13. @FacesValidator ("myvalidator") 

14. public class MyValidator implements Validator { 

15. override 

16. public void validate (FacesContext context,UIComponent component,Object value) 


L throws ValidatorException { 
0. StringBuilder sb=new StringBuilder (value.toSstring()); 
19. int i=0; 

20。 while(i<sb.length()){ 

21。 char ch=sb.charat (i); 

Fe if(!Character.isLetter (ch)){ 

23， Application app=context .getApplication(); 

24. String baseName=app.getMessageBundle (); 

4 if(baseName!=null){ 

26, String mid="msg1"; 

27. String summary=null; 

28. String detail=null; 

29., try{ 


I 


30 . 
Ss 
32。 
33; 
34. 
35, 
36. 
Sls 
38. 
EL 
40. 
41. 
42. 
43. 


ResourceBundle mb=ResourceBundle.getBundle (baseName) 

Summary=rmb .getString (mid) 7 

detail=mb.getString (mid+" detail"); 
} catch (MissingResourceException mre){} 
detail=MessageFormat .format (detail,value); 
FacesMessage fmsg=new FacesMessage (summary, detail); 
fmsg.setSeverity (FacesMessage.SEVERITY ERROR); 


throw new ValidatorException (fmsg); 


i++; 


类 头 的 标注 @FacesValidator("myvalidator") 表 明 该 自 定 义 验 证 器 类 按 标 注 方式 进行 
了 注册 ,注册 ID 为 myvalidator 。 

3. JSF 页 面 

创建 JSF 页 面 indexl. xhtml( 代 码 清单 9-11) 。 该 页 面 与 9. 2. 2 节 介绍 的 页 面 index. 
xhtml 基本 相同 ,只 是 为 文本 域 引用 了 两 个 验证 器 : 一 个 是 标准 验证 器 ,确保 输入 串 的 长 度 


必须 大 于 等 于 


一 个 是 自 定义 验证 器 ,要 求 用 户 只 能 输入 字母 。 另 外 为 文本 域 设置 了 一 个 


消息 组 件 , 用 于 显示 验证 出 错 消 息 。 
代码 清单 9-11 JSF 页 面 (indexl. xhtml) 


1。 
2. 


<?xml version='1.0' encoding= 'UTF-8"' ?> 
< !DOCTYPE html PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1l/DTD/xhtmll-transitional.dtd"> 


.<html xmlns="http://www.w3.0rg/1999/xhtml" 


xmlns:h="http://java.sun.com/jsf/html" 
xmlns:f="http://java.sun.com/jsf/core"> 
<h:head> 
<title>ResourceBundleDemo</title> 
</h:head> 
<h:body> 
<h:form id="f"> 
<p><h:outputLabel for 


"value="#{rbl.prompt}"/></p> 


<p> 


<h:inputText id: value="#{index.value}"> 
<f:validateLength minimum="5"/> 
<f:validator validatorId="myvalidator"/> 
</h:inputText> 
<h:message for="i"/> 
</p> 
<p><h:commandButton value="#{rbl.button title}"/></p> 


</h:form> 


22. <p> 


23。 <h:outputFormat value="#{rbl.result}"> 
24. <f:param value="#{index.value}"/> 
2 </h:outputFormat> 
26% </p> 
27. </h:body> 
28. </html> 
9.3 际 化 


一 个 场所 代表 一 个 有 特定 地 理 、 政 治 或 文化 的 区 域 ,每 个 场所 有 各 自 的 语言 ,传统 或 习 
惯 。 国 际 化 (Internalization, il8n) 是 指 通过 设计 ,使 软件 能 够 适应 多 种 场所 的 能 力 或 潜力 。 
本 地 化 (Localization, 110n) 是 指 在 软件 中 添加 与 特定 场所 有 关 的 信息 使 其 能 适应 特定 场所 
的 过 程 。 

就 如 上 节 所 介绍 的 ,使 用 资源 包 的 一 个 好 处 是 支持 页 面 中 的 静态 文本 、 消 息 以 及 消息 模 
板 等 能 从 页 面 中 分 离 出 来 集中 管理 ,便于 系统 维护 。 使 用 资源 包 的 另 一 个 好 处 是 支持 国际 
化 和 本 地 化 , 即 若 要 让 应 用 适应 一 个 新 的 场所 ,只 需要 添加 额外 的 资源 包 或 消息 包 , 而 不 需 
要 修改 页 面 代码 。 本 节 介绍 这 方面 的 技术 。 


9.3.1 场所 


在 Java 中 ,一 个 场所 (Locale) 用 一 个 Locale 类 的 实例 表示 ,其 状态 主要 由 语言 和 国家 
(地 区 ) 两 个 数据 表示 。 下 面 是 Locale 类 的 两 个 常用 的 构造 方法 : 


Locale (String language) 


Locale (String language String country) 


其 中 ,参数 language 指定 场所 的 语言 ,用 ISO-639 定义 的 .小 写 的 两 字母 代码 表示 ,如 en( 英 
语 ) .zh( 中 文 ) 等 ;参数 country 指定 场所 的 国家 或 地 区 ,用 ISO-3166 定义 的 \ 大 写 的 两 字母 
代码 表示 ,如 CN( 中 国 )、US( 美 国 ) 等 。 在 有 些 场合 ,也 会 用 这 些 代码 来 表示 某 个 场所 ,如 
zh、zh_CN、en、en_US 等 。 

创建 Locale 实例 时 ,构造 方法 会 自动 完成 字母 的 大 小 写 转换 ,即将 语言 代码 转换 成 小 
写 , 将 国家 (地 区 ) 代 码 转 换 成 大 写 ,但 不 会 对 参数 做 进一步 的 验证 。 所 以 , 若 指定 的 参数 不 
对 ,创建 的 Locale 对 象 并 不 能 表示 一 个 有 效 的 场所 。 但 指定 的 参数 必须 是 非 null, 否则 会 
抛 出 NullPointerException 例外 。 

Locale 类 定义 了 一 些 常用 的 Locale 型 的 类 的 有 名 常量 。 很 多 时 候 , 可 以 直接 引用 它 
们 ,而 不 必 再 显 式 创建 表示 相同 场所 的 Locale 实例 。 下 面 列 出 其 中 的 几 个 ,并 对 其 状态 值 
进行 说 明 。 

。 Locale. ENGLISH : en( 英 语 )。 

。 Locale. US: en_US( 英 语 美国 )。 

。 Locale. UK: en_GB( 英 语 英国 )。 

。 Locale. CHINESE: zh( 中 文 )。 

和 


。 Locale.CHINA: zh_CN( 中 文 中国) 。 

。 Locale. TAIWAN: zh_TW( 中 文 _ 台 湾 ) 。 

Locale 类 同样 定义 了 一 些 公 共 的 实例 方法 和 类 方法 ,下 面 是 其 中 的 几 个 。 

(1) String getCountry() : 返回 当前 场所 的 国家 (地 区 ) 代 码 。 

(2) String getLanguage() : 返回 当前 场所 的 语言 代码 。 

(3) getDisplayCountry(): 返回 当前 场所 的 国家 (地 区 ) 名 称 , 该 名 称 通常 会 依据 默认 
场所 进行 本 地 化 。 

(4) getDisplayLanguage(): 返回 当前 场所 的 语言 名 称 ,该 名 称 通常 会 依据 默认 场所 进 
行 本 地 化 。 

(5) static Locale getDefault() : 返回 当前 Java 虚拟 机 的 默认 场所 。 

(6) static void setDefault(Locale newLocale) : 设置 当前 Java 虚拟 机 的 默认 场所 。 

LocaleDemo. java( 代 码 清单 9-12) 是 一 个 Java 应 用 程序 ,演示 了 Locale 类 中 的 一 些 常 
量 和 方法 的 使 用 。 在 不 同 的 默认 场所 情况 下 ,一 个 场所 的 语言 .国家 代码 总 是 相同 的 ,但 其 
名 称 往往 是 不 同 的 。 

代码 清单 9-12 ”使 用 Locale 类 


1. import java.util.Locale; 
2. public class LocaleDemo { 


3. Ppublic static void main(String[] args){ 


4 Locale locale=new Locale ("en", "US"); 
s System.out.println("Default:"+Locale.getDefault ()); 
6 System.out .Println(locale.getLanguage ()+" "+locale.getCountry()); 
Ts System.out .Println (locale.getDisplayLanguage()+" "+locale.getDisplayCountry()); 
8 Locale.setDefault (Locale.US); // 设 置 默 认 场 所 
9 System.out.println("Default:"+Locale.getDefault ()); 
10. System.out.println(locale.getLanguage()+" "+locale.getCountry()); 
3 System.out .println (locale.getDisplayLanguage ()+" "+locale.getDisplayCountry()); 
2 } 
13。} 
程序 的 运行 结果 如 下 : 
Default:zh_CN 
en_US 
英文 美国 
Default:en US 
en_US 


English United States 


9.3.2 创建 不 同 场 所 的 资源 包 


对 一 组 资源 ,应 用 可 以 为 其 所 支持 的 各 场所 创建 各 自 的 资源 包 类 (或 属性 文件 ) ,这 些 资 
源 包 类 形成 一 个 资源 包 族 。 通常 ,一 个 资源 包 族 应 包含 一 个 默认 资源 包 类 ,该 默认 资源 包 类 
的 类 名 称 为 资源 包 族 的 基 名 。 资 源 包 族 中 其 他 资源 包 类 的 类 名 应 在 基 名 的 基础 上 添加 它 所 
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支持 的 场所 的 相关 代码 。 

下 面 是 基 名 为 bundle. BundleOne 的 一 个 资源 包 族 : 

。 bundle. BundleOne。 

。 bundle. BundleOne_zh 。 

。 bundle. BundleOne_zh_CN。 

。 bundle. BundleOne_zh_TW。 

。 bundle. BundleOne_en。 

。 bundle. BundleOne_en_US 。 

。 bundle. BundleOne_en_UK 。 

以 上 资源 包 族 的 每 个 成 员 既 可 以 是 Java 类 ,也 可 以 是 属性 文件 。 如 果 两 者 同时 出 现 ， 
优先 使 用 类 文件 ,属性 文件 被 忽略 。 

总 的 来 说 ,资源 包 族 的 每 个 成 员 定义 有 相同 的 资源 条 目 ,但 每 个 资源 条 目 在 各 成 员 中 会 
有 不 同 的 值 。 但 不 能 排除 有 些 资 源 条 目 在 不 同 的 成 员 ( 特 别 是 具有 相同 语言 的 各 成 员 ) 中 会 
有 相同 的 值 。 所 以 进一步 地 ,可 以 在 只 涉及 语言 的 成 员 ( 如 bundle. BundleOne_en) 中 定义 
一 些 公 共 的 资源 条 目 , 而 在 涉及 国家 (地 区 ) 的 成 员 ( 如 bundle. BundleOne_en_US) 中 定义 
针对 该 国家 (地 区 ) 特 有 的 资源 条 目 。 


9.3.3 资源 包 链 与 资源 定位 


第 9.1.3 节 曾 经 介绍 ResourceBundle 类 的 getBundle 方法 , 它 可 以 创建 或 获取 指定 基 
名 的 资源 包 。 但 基 名 究竟 是 什么 ?方法 是 否 一 定 返回 指定 类 的 资源 包 实例 ?实际 上 还 没有 
明确 的 说 明 。 下 面 将 再 次 列 出 该 方法 的 两 种 格式 ,并 做 进一步 的 说 明和 讨论 。 

格式 1: 


public static final ResourceBundle getBundle (String baseName) 
格式 2: 
public static final ResourceBundle getBundle (String baseName,Locale locale) 


两 种 格式 都 需要 指定 基 名 。 基 名 就 是 一 个 资源 包 族 的 基 名 ,也 即 资源 包 族 中 默认 资源 
包 类 的 完整 类 名 。getBundle 方法 就 是 在 指定 的 资源 包 族 中 创建 或 获取 相关 的 资源 包 。 

getBundle 方法 是 与 场所 相关 的 。 如 果 没有 指定 场所 参数 (第 1 种 格式 ) ,方法 创建 或 获 
取 与 Java 虚拟 机 默认 场所 相关 的 资源 包 。 以 第 9. 3. 2 节 所 述 资源 包 为 例 , 如 果 Java 虚拟 机 
的 默认 场所 为 zh_CN ,那么 下 面 代 码 : 


ResourceBundle rbl=ResourceBundle.getBundle ("bundle.Bundleone") 7 


将 创建 或 获取 以 下 资源 包 , 这 些 资 源 包 形成 一 条 链 , 称 为 资源 包 链 。 其 中 BundleOne_ 
zh 是 BundleOne_zh_CN 的 父 资源 包 ,BundleOne 是 BundleOne_zh 父 资源 包 。 方法 返回 的 
资源 包 是 BundleOne_zh_CN。 
。 bundle. BundleOne _ zh_CN. 
。 bundle. BundleOne _ zh。 
。 bundle. BundleOne。 
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当 调 用 getBundle 方法 返回 的 资源 包 rbl 的 getString 或 getObject 方法 时 ,首先 会 在 
当前 资源 包 (BundleOne_zh_CN) 中 寻找 指定 的 资源 ,如 果 在 该 资源 包 中 找 不 到 指定 的 资 
源 , 则 方法 自动 到 它 的 父 资 源 包 (BundleOne_zh) 中 寻找 指定 的 资源 ,以 此 类 推 。 

如 果 在 调用 getBundle 方法 时 指定 场所 参数 (第 2 种 格式 ), 方 法 将 创建 或 获取 与 指定 
场所 以 及 Java 虚拟 机 默认 场所 相关 的 资源 。 以 9. 3. 2 节 所 述 资 源 包 为 例 , 如 果 默 认 场 所 为 
zh_CN, 那 么 下 面 代码 : 


ResourceBundle rb=ResourceBundle.getBundle ("bundle.BundleOne", Locale.US); 


将 创建 或 获取 以 下 资源 包 , 这 些 资源 包 形 成 一 条 链 , 后 面 的 资源 包 是 前 面 资源 包 的 父 资 
源 包 。 方法 返回 的 资源 包 是 BundleOne_en_US。 

。 bundle. BundleOne_en_US。 

。 bundle. BundleOne_en。 

。 bundle. BundleOne_zh_CN。 

。 bundle. BundleOne_zh。 

。 bundle. BundleOne。 

当 调用 getBundle 方法 返回 的 资源 包 rb2 的 getString 或 getObject 方法 时 ,首先 会 在 
当前 资源 包 (BundleOne_en_US) 中 寻找 指定 的 资源 ,如 果 在 该 资源 包 中 找 不 到 指定 的 资 
源 , 则 方法 自动 到 它 的 父 资源 包 (BundleOne_en) 中 寻找 指定 的 资源 ,以 此 类 推 。 

通常 ,一 个 资源 包 族 应 包含 一 个 默认 资源 包 类 。 从 上 面 的 介绍 可 以 看 出 ,相应 的 默认 资 
源 包 是 用 户 定位 资源 的 最 后 机 会 ,也 就 是 说 ,如 果 在 其 他 相关 资源 包 中 找 不 到 所 需 资源 ,最 
终 都 会 到 默认 资源 包 中 寻找 。 

但 这 并 不 是 说 ,默认 资源 包 是 必 不 可 少 的 ,或 者 说 ,在 一 个 资源 包 族 中 ,默认 资源 包 类 是 
必须 存在 的 。 应 该 说 ,一 个 资源 包 族 可 以 没有 所 谓 的 默认 资源 包 类 ,但 即使 没有 默认 资源 包 
类 ,资源 包 族 的 基 名 仍然 是 存在 的 ,ResourceBundle 的 getBundle 仍然 是 根据 基 名 来 获取 相 
关 的 资源 包 , 或 者 说 获取 一 个 资源 包 链 。 当 然 ,此 时 获得 的 资源 包 链 中 不 会 有 默认 资源 包 。 


9.3.4 JSF 应 用 国际 化 


与 独立 的 Java 应 用 程序 相 比 ,JSF 应 用 的 国际 化 强调 的 是 它 能 被 不 同 场所 的 用 户 访 
问 ,而 不 是 一 定 要 将 它 移植 到 不 同 的 场所 运行 。 当 处 于 不 同 场所 的 用 户 通过 互联 网 进行 访 
问 时 ,JSF 应 用 应 该 能 用 最 合适 的 语言 .习惯 格式 等 产生 用 户 能 够 理解 和 接受 的 响应 。 

考虑 资源 包 在 JSF 应 用 中 的 国际 化 应 用 ,首先 应 该 为 JSF 应 用 设置 合适 的 资源 包 族 ， 
为 每 一 个 资源 包 族 创建 为 支持 某 些 场 所 而 所 需 的 成 员 , 相 关 概 念 与 技术 已 在 前 面 介绍 。 同 
时 也 需要 向 JSF 框架 声明 该 应 用 支持 哪些 场所 以 及 它 的 默认 场所 是 什么 。 这 种 声明 是 在 
Faces 配置 文件 中 使 用 locale-config 元 素来 完成 的 ,下 面 是 一 个 示例 。 


<application> 
<locale- config> 
<default-locale>en</default-locale> 
<supported- locale>en US</supported-locale> 
<supported- locale>en</supported-locale> 
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<supported- locale>zh CN</supported-locale> 
<supported- locale>zh</supported-locale> 
</locale-config> 


</application> 


locale-config 元 素 是 application 元 素 的 子 元 素 ,其 中 可 包含 一 个 default-locale 子 元 素 ， 
用 于 指定 当前 应 用 的 默认 场所 ;可 以 包含 多 个 supported-locale 子 元 素 , 用 于 指定 当前 应 用 
所 支持 的 各 场所 。 应 用 的 默认 场所 可 以 通过 调用 其 Application 对 象 的 getDefaultLocale 
方法 获得 ;应 用 所 支持 的 所 有 场所 可 调用 其 Application 对 象 的 getSupportedLocales 方法 
获得 。 

Application app=FacesContext.getCurrentInstance() .getApplication(); 


Locale locale=app.getDefaultLocale(); 


Iterator<Locale>iter locale=getSupportedLocales (); 


另外 ,也 需要 了 解 JSF 框架 为 视图 选择 场所 的 机 制 , 即 一 个 视图 应 该 基于 哪 种 场所 来 
进行 呈现 。 总 的 来 说 ,JSF 框架 会 依据 用 户 的 请 求 信息 (客户 端 浏览 器 能 够 接受 的 语言 , 即 
请 求 头 Accept-Language 的 值 ) 与 应 用 能 支持 的 场所 信息 来 确定 当前 视图 的 场所 。 具 体 来 
说 ,JSF 框架 在 创建 视图 时 ,将 按 以 下 顺序 优先 为 其 选择 最 恰当 的 场所 : 

。 上 一 个 视图 所 用 的 场所 ; 

。 客户 端 浏览 器 能 接受 的 语言 与 应 用 支持 的 场所 相 匹 配 的 场所 ; 

。 应 用 的 默认 场所 ; 

。 支持 JSF 运行 的 Java 虚拟 机 的 默认 场所 。 

通过 导航 请 求 的 新 视图 总 是 采用 上 一 个 视图 的 场所 ,只 有 在 初始 请 求 一 个 视图 时 才 需 
要 根据 请 求 信息 做 进一步 的 选择 。 客 户 端 浏览 器 能 接受 的 语言 可 能 有 多 种 ,每 一 种 都 会 与 
应 用 支持 的 各 场所 进行 比较 。 如 果 浏 览 器 能 接受 的 所 有 语言 与 应 用 支持 的 各 场所 都 不 能 匹 
配 , 则 选择 应 用 的 默认 场所 。 如 果 应 用 没有 指定 默认 场所 , 则 选择 Java 虚拟 机 的 默认 场所 。 

JSF 框架 选 定 的 场所 被 保存 在 当前 视图 根 (UIViewRoot) 的 locale 属性 中 。 应 用 代码 
也 可 以 根据 需要 改变 该 属性 。 

。 public Locale getLocale() ; 

。 public void setLocale(Locale locale) ; 

当 JSF 框架 在 计算 一 些 访问 资源 的 EL 值 表 达 式 时 ,以 及 标准 转换 器 、 验 证 器 在 出 现 处 
理 异常 需要 错误 消息 时 ,都 会 基于 资源 包 族 的 基 名 和 该 locale 属性 指定 的 场所 、 利 用 格式 2 
的 getBundle 方法 定位 相关 的 资源 包 或 消息 包 , 进 而 获取 客户 端 可 理解 的 资源 或 消息 文本 。 

同样 的 道理 ,特别 是 在 国际 化 的 JSF 应 用 中 , 自 定义 转换 器 、 验 证 器 以 及 事件 监听 器 在 
出 现 处 理 异常 需要 错误 消息 时 ,也 应 该 采用 这 种 方式 。 否 则 ,如 果 只 是 基于 资源 包 族 的 基 
名 、 采 用 格式 1 的 getBundle 方 法 定位 相关 的 资源 包 或 消息 包 , 那 么 只 能 获取 JSF 应 用 所 在 
的 Java 虚拟 机 的 默认 场所 相关 的 资源 和 消息 。 


9.3.5 国际 化 应 用 示例 


该 示例 在 之 前 示例 (ch9_bundle) 的 基础 上 进行 修改 和 扩充 而 成 ,用 以 演示 开发 基于 资 
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源 包 的 国际 化 的 JSF 应 用 的 基本 过 程 和 方法 。 为 避免 影响 之 前 示例 的 运行 效果 ,这 里 为 该 
示例 新 建 一 个 应 用 项 目 , 命 名 为 ch9_locale。 

该 项 目 仅 包含 一 个 JSF 页 面 index. xhtml. 其 代码 与 项 目 ch9_bundle 中 的 indexl. 
xhtml 完全 相同 。 其 运行 效果 如 图 9-3 所 示 。 如 果 客 户 端 浏 览 器 能 够 接受 zh-cn( 中 国 中 
文 ), 且 优先 于 en( 英 文 ), 那 么 呈现 效果 如 图 9-3(a) 所 示 , 和 否则 呈现 效果 如 图 9-3(b) 所 示 。 


[器 Mp /ocahost e000/che 1ocale/ foces/inder zhinl 


Fontain non-letter characters: we2we 


The value you enter is 


图 9-3 国际 化 应 用 ch9_locale 


该 应 用 项 目 同样 包含 一 个 受 管 bean 类 bean. Index ,与 项 目 ch9_bundle 中 的 受 管 bean 
类 bean. Index 完全 相同 。 

除 此 之 外 ,作为 一 个 国际 化 的 JSF 应 用 ,这 里 主要 要 为 它 所 支持 的 场所 定义 相应 的 资 
源 包 和 消息 包 ,并 进行 必要 的 声明 。 另 外 需要 修改 自 定义 验证 器 ,使 其 能 根据 与 客户 端 相 适 
应 的 场所 来 创建 相应 的 消息 对 象 。 

1. 资源 包 与 消息 包 

首先 为 应 用 设置 资源 包 族 ,并 为 每 个 资源 包 族 定义 应 用 所 支持 场所 相应 的 资源 包 类 或 
属性 文件 。 该 项 目 包 含 一 个 资源 包 族 (BundleOne) 和 一 个 消息 包 族 (mymsg), 各 有 两 个 成 
员 : 一 个 支持 zh_CN ,一 个 支持 en。 该 资源 包 族 和 消息 包 族 的 各 成 员 都 采用 属性 文件 定 
义 。 下 面 列 出 各 属性 文件 ,其 中 前 面 两 个 是 资源 包 族 的 成 员 , 后 面 两 个 是 消息 包 族 的 成 员 。 

。 bundle/BundleOne_zh_CN. properties 。 

。 bundle/BundleOne_en. properties。 

。 bundle/mymsg_zh_CN. properties 。 

。 bundle/mymsg_en. properties。 

这 里 ,属性 文件 BundleOne_zh_CN 包含 的 资源 文本 与 之 前 项 目 (ch9_bundle) 中 的 资源 
包 类 BundleOne. java 定义 的 资源 完全 相同 ,属性 文件 BundleOne_en 只 是 用 英文 来 表达 上 
述 资源 文本 。 属 性 文件 mymsg_zh_CN 的 内 容 与 之 前 项 目 (ch9_bundle) 中 的 属性 文件 
mymsg 的 内 容 完 全 相同 ,属性 文件 mymsg_en 只 是 用 英文 来 表达 这 些 内 容 。 

有 关 资 源 包 和 消息 包 的 注册 声明 与 之 前 项 目 (ch9_bundle) 中 的 注册 声明 完全 相同 。 

2. 声明 应 用 支持 的 场所 

在 Faces 配置 文件 中 声明 应 用 支持 的 场所 以 及 应 用 的 默认 场所 。 


<application> 
<locale-config> 
<default- locale>en</default- locale> 
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<supported- locale>en</supported-locale> 
<supported- locale>zh CN</supported-locale> 
</locale-config> 


</application> 


该 应 用 支持 两 种 场所 : en 和 zh_CN。 如 果 客 户 端 浏览 器 同时 支持 这 两 种 场所 (语言 ) ,就 看 
哪个 场所 排 在 请 求 头 Accept-Language 的 值 的 前 面 。 例 如 , 若 请 求 头 Accept-Language 的 
值 为 "en，zh-cn” ,那么 JSF 框架 为 当前 视图 选择 的 场所 就 为 en。 如 果 客 户 端 浏 览 器 既 不 支 
持 en, 也 不 支持 zh_CN ,那么 为 当前 视图 选择 的 场所 将 是 应 用 的 默认 场所 ,也 就 是 en。 

可 以 用 以 下 操作 设置 浏览 器 可 接受 的 语言 : 工具 | 选项 (Internet 选项 ) | 语言 。 

3. 修改 自 定义 验证 器 

在 国际 化 的 JSF 应 用 中 , 自 定义 转换 器 、 验 证 器 以 及 事件 监听 器 的 编写 也 需要 考虑 场 
所 的 因素 。 

该 项 目 包含 一 个 自 定义 验证 器 类 validator. MyValidator, 它 与 之 前 项 目 (ch9_bundle) 
中 的 自 定 义 验 证 器 类 基本 相同 ,只 是 把 其 中 的 代码 : 


ResourceBundle mb=ResourceBundle .getBundle (baseName) 
改 为 : 


Locale locale=FacesContext .getCurrentInstance () .getViewRoot () .getLocale(); 


ResourceBundle mb=ResourceBundle .getBundle (baseName,1locale); 


之 前 的 代码 返回 的 是 与 Java 虚拟 机 的 默认 场所 相关 的 资源 包 , 而 改进 后 的 代码 则 返回 
与 客户 所 在 场所 相关 的 资源 包 。 


9.4 小 结 


。 资源 包 是 ResourceBundle 抽象 类 的 某 个 具体 子 类 的 实例 ,由 一 组 键 一 值 对 组 成 。 

资源 包 不 能 由 new 表达 式 创建 ,而 是 通过 调用 ResourceBundle 类 的 getBundle 方法 

来 创建 或 获取 。 

资源 包 可 以 基于 ResourceBundle 抽象 类 的 某 个 具体 子 类 创建 ,也 可 以 基于 属性 文 

件 创建 。 

在 JSF 中 ,可 以 在 Faces 配置 文件 中 用 resource-bundle 元 素 注 册 资源 包 , 或 者 在 

JSF 页 面 中 用 f:loadBundle 标记 装 人 资源 包 。 

一 个 场所 用 一 个 Locale 类 的 实例 表示 ,其 状态 主要 由 语言 和 国家 (地 区 ) 两 个 数据 

表示 。 

对 一 组 资源 ,可 以 为 所 支持 的 各 场所 创建 各 自 的 资源 包 类 (或 属性 文件 ) ,这些 资 源 

包 类 形成 一 个 资源 包 族 。 每 个 资源 包 族 应 该 有 一 个 基 名 。 

。 调用 ResourceBundle 类 的 getBundle 方法 获取 的 是 指定 基 名 和 场所 的 一 个 资源 包 
链 。 当 应 用 访问 一 个 资源 时 ,系统 会 从 资源 包 链 中 的 某 个 资源 包 中 获取 并 返回 相应 
的 资源 。 
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消息 包 是 一 种 资源 包 , 用 于 JSF 的 消息 机 制 ,可 以 作为 FacesMessage 消息 对 象 的 消 
息 文本 来 源 。 一 个 JSF 应 用 只 能 注册 一 个 消息 包 ( 族 )。 

标准 转换 和 验证 消息 文本 都 定义 在 JSF 框架 提供 的 标准 消息 包 族 中 ,这 个 标准 消息 
包 族 的 基 名 是 javax. faces. Messages。 


习 题 9 


1. 简 述 创建 PropertyResourceBundle 型 资源 包 的 方法 和 过 程 。 
2. 简 述 消息 包 不 同 于 一 般 资源 包 的 地 方 。 
4 


术语 解释 : Java 虚拟 机 默认 场所 、JSF 应 用 默认 场所 。 
简 述 ResourceBundle 类 中 定义 的 getBundle(String) 和 getBundle(String, Locale) 


静态 方法 的 功能 区 别 。 


5. 


创建 一 个 JSF 应 用 项 目 sh9_locale。 项 目 中 包含 两 个 JSF 页 面 : index. xhtml 显示 


登录 界面 ,response. xhtml 是 对 登录 的 响应 。 应 用 支持 中 文 和 英文 两 种 语言 ,运行 效果 如 
图 9-4 所 示 。 


il81 — Wozilla Firefox 回回 因 orilla Firefox 国 [E]lE3 
人 编辑 下) 查看 WW) 历史 G) 书签 @) 文件 人 F) 编辑 EF) 查看 (VW) 历史 G) 书签 @) 


B http://locdlhost soe0/st9_ [el p <€ ~ 外 = |B http;//loecalhost:8080/sh9_ > Bp 
中 文 


Please Login 


用 户 名 讲 明 ] UserName [ito Narm 
SB es |] Passwordlrme | 


il81 — Wozilla Firefox 国 |[ajlEd 


查看 W) 历史 G) 书签 @) 


= | 日 http://localhost:a080/xh9_ [| DD) = | http://localhost:8080/sh9. [| | 


welcome!Kito Nann 


过 成 


图 9-4 习题 5 示意 图 
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第 10 章 模板 与 复合 组 件 


本 章 主题 : 

。 包含 

。 基于 模板 页 创建 视图 页 面 
。 基于 客户 页 创建 视图 页 面 
。 ui:param 与 ui:repeat 

。 创建 复合 组 件 

。 配置 复合 组 件 

。 公开 复合 组 件 

。 打包 复合 组 件 


相对 基于 JSP 视图 技术 ,Facelets 视图 技术 不 仅 有 一 个 更 好 的 视图 处 理 器 ,而 且 提 供 模 
板 、 复 合 组 件 等 特性 。 

模板 技术 支持 页 面 布局 ,样式 和 内 容 的 封装 和 重用 。 通 过 定义 和 维护 封装 有 页 面 布局 、 
样式 和 内 容 的 单个 模板 ,用户 可 以 在 多 个 页 面 中 重用 这 个 模板 。 这 也 使 得 这 些 页 面具 有 一 
致 的 标准 外 观 。 

复合 组 件 技术 用 于 将 现 有 的 组 件 和 标记 组 合成 一 个 具有 特定 功能 的 可 重用 的 自 定义 组 
件 。 与 其 他 普通 的 JSF 组 件 一 样 ,复合 组 件 也 可 以 进行 属性 设置 ,也 可 以 注册 所 需 的 验证 
器 、 转 换 器 和 监听 器 。 

模板 和 复合 组 件 特性 从 不 同 的 角度 支持 对 页 面 内 容 的 封装 和 重用 ,对 JSF 应 用 、 尤 其 
是 用 户 界面 的 开发 .设计 和 维护 具有 重要 的 意义 。 

模板 特性 主要 由 Facelets 标记 库 支 持 。 要 使 用 Facelets 标记 库 , 需 要 在 XHTML 文件 
中 添加 一 个 名 称 空间 声明 ,如 下 所 示 : 

xmlns:ui="http://java.sun.com/jsf/facelets" 
该 标记 库 除 了 支持 模板 特性 ,也 包含 实现 其 他 功能 的 一 些 标记 。 本 章 10. 1 节 至 10. 3 节 介 
绍 的 都 是 该 标记 库 中 的 标记 。 

复合 组 件 特性 主要 由 复合 标记 库 支 持 。 在 定义 复合 组 件 时 ,需要 在 XHTML 文件 中 添 
加 如 下 的 名 称 空间 声明 : 

xmlns:cc="http://java.sun.com/jsf/composite" 

说 明 : 对 复合 标记 库 ,通常 取 composite 作为 其 空间 名 称 ( 标 记 的 前 级 ) ,但 也 可 以 取 其 
他 的 名 称 。 本 书 采用 cc 作为 复合 标记 的 前 级 。 

本 章 10.4 节 至 10.7 节 介 绍 创建 和 使 用 复合 组 件 的 技术 。 
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10.1 包含 


在 JSF 中 ,一 个 视图 页 面 可 以 被 认为 由 相对 独立 的 节 组 成 。 有些 节 的 内 容 可 能 会 出 现 
在 多 个 页 面 中 ,这 时 可 以 将 该 节 内 容 进 行 独立 封装 和 定义 , 称 为 节 内 容 页 。 普 通 的 JSF 页 
面 (可 称 为 包含 页 ) 可 以 将 节 内 容 页 包含 进来 ,形成 完整 的 视图 页 面 。 

通常 , 节 内 容 页 也 是 一 个 XHTML 文件 ,其 中 节 的 内 容 被 包含 在 ui:composition 标记 
内 。 包 含 页 可 以 利用 ui:include 标记 装 人 指定 的 节 内 容 页 。 

下 面 通过 示例 说 明 包 含 特性 的 使 用 ,涉及 的 文件 都 存在 于 ch10_includeAndTemplate 
应 用 项 目 。 当 用 户 请 求 包含 页 (page_one. xhtml) 时 将 呈现 如 图 10-1 所 示 的 响应 。 


ui:include — Wozilla Firefox 


文件 人 编辑 E) 查看 VW 历史 (5) 书签 @) 工具 (1) 才 助 0 


<@ - 蕉 -| 日 Metp://lecahoste0so/chl0_includehndTenplatwyfaces/page_one xhtnl 


包含 (ui :include) 特性 示例 


图 10-1 包含 示例 运行 效果 图 


代码 清单 10-1 给 出 的 是 节 内 容 页 。 这 里 ,真正 的 节 内 容 就 是 包含 于 ui:composite 标记 
的 文本 。 
代码 清单 10-1 节 内 容 页 (section/section_one. xhtml) 


1. <?xml version='1.0' encoding='UTF-8' ?> 

2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
3 "http://www.w3.0rg/TR/xhtmll/DTD/xhtmll-transitional.dtd"> 
4. <html xmlns="http://www.w3.0rg/1999/xhtml" 

5 xmlns:h="http://java.sun.com/jsf/html" 

6 xmlns:ui="http://java.sun.com/jsf/facelets"> 

7 <h:head> 

8 <title>Facelet Title</title> 

9 </h:head> 


10. <h:body> 


11. <ui:composition> 
Ye 节 内 容 
3 </ui:composition> 


14. </h:body> 
15. </html> 


代码 清单 10-2 给 出 的 是 包含 页 。 其 中 ,ui:include 标记 的 src 属性 指定 节 内 容 页 文件 。 
其 文件 路 径 应 采用 相对 路 径 : 如 果 不 以 斜 杠 开头 . 则 相对 于 包含 页 面 文件 所 在 的 路 径 ; 如 果 


以 斜 杠 (/) 开 头 , 则 相对 于 应 用 的 上 下 文 路 径 ( 不 需要 /faces)。 
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代码 清单 10-2 包含 页 面 (page_one. xhtml) 


1. <?xml version="1.0" encoding= "UTF-8" ?> 

2. <!DOCTYPE html PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 
3. "http://www.w3.0rg/TR/xhtmll/DTD/xhtmll-transitional.dtd"> 
4. <html xmlns="http://www.w3.0rg/1999/xhtml" 

5 xmlns:h="http://java.sun.com/jsf/html" 

6 xmlns:ui="http://java.sun.com/jsf/facelets"> 
7. <h:head> 
8 
9 


<title>ui:include</title> 


</h:head> 
10. <h:body> 
Ls <p> 包 含 (ui:include) 特 性 示例 < /p> 
Ys <ui:include src="section/section one.xhtml"/> 
13. </h:body> 
14. </html> 


当 JSF 框架 处 理 ui:include 标记 时 ,会 把 节 内 容 页 中 ui:composition 标记 包含 的 内 容 
读 取 ,插入 到 包含 页 中 ui:include 标记 所 在 处 。 节 内 容 页 中 ui:composition 标记 外 面 的 内 
容 被 忽略 。 

除了 重用 的 目的 ,对 一 些 较为 复杂 的 JSF 页 面 ,同样 可 以 采用 包含 技术 ,即将 一 些 节 内 
容 进 行 独立 封装 和 定义 ,而 源 页 面 再 通过 ui:include 标记 将 它们 包含 进来 装配 成 完整 的 视 
图 页 面 。 这 相当 于 把 一 个 复杂 的 问题 分 解 成 若干 简单 的 小 问题 来 解决 , 既 便于 开发 .也 利于 
维护 。 


10. 2 Facelets 模板 


在 Facelets 模板 技术 中 ,一 个 普通 的 视图 页 面 被 划分 为 模板 页 和 客户 页 两 部 分 。 模 板 
页 定义 应 用 中 一 些 视 图 页 面 共有 的 页 面 布局 ,样式 和 内 容 , 客 户 页 定义 某 页 面 视图 特有 的 布 
局 .样式 和 内 容 。 客 户 页 通过 应 用 模板 页 形成 完整 的 视图 页 面 。 

在 模板 页 中 ,有 些 节 内 容 可 以 被 定义 成 是 可 变 的 ,可 以 由 客户 页 提供 具体 内 容 。 

在 JSF 中 ,主要 有 两 种 使 用 模板 技术 的 方式 ,下 面 分 别 介绍 。 


10.2.1 基于 模板 页 创建 视图 页 面 


采用 这 种 方式 时 ,一般 应 首先 分 析 应 用 中 的 各 视图 页 面 , 找 出 它们 共同 的 布局 ,样式 和 
内 容 , 定 义 相 应 的 模板 页 。 然 后 再 为 每 个 视图 页 面 定 义 相 应 的 客户 页 ,在 客户 页 中 调用 模板 
页 ,并 定义 其 特有 的 布局 .样式 和 内 容 。 

在 这 种 方式 中 ,模板 页 是 形成 最 终 视图 页 面 的 基础 ,应 包含 一 个 视图 页 面 应 该 有 的 各 部 
分 内 容 。 

下 面 通过 示例 说 明 如 何 采用 该 种 方式 使 用 Facelets 模板 特性 ,其 中 涉及 的 文件 都 存在 
于 ch10_includeAndTemplate 应 用 项 目 。 当 用 户 请 求 客 户 页 (client_one. xhtml) 时 将 呈现 
图 10-2 所 示 的 响应 。 
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Facelets Teaplate 1 一 Wozilla Firefox 


页 头 


图 10-2 模板 应 用 示例 运行 效果 图 


代码 清单 10-3 给 出 的 是 模板 页 。 其 中 共 含 3 个 ui:insert 标记 ,每 个 标记 定义 了 一 个 内 
容 可 变 的 节 , 每 个 节 的 内 容 可 由 客户 页 提供 。 以 第 一 个 ui:insert 标记 为 例 , 该 标记 定义 了 
一 个 名 称 为 top 的 节 ( 由 标记 的 name 属性 指定 ), 节 中 有 默认 的 内 容 , 即 DefaultTop。 如 果 
客户 页 没有 为 该 节 提 供 具体 的 内 容 ,那么 最 终 的 视图 页 面 将 默认 该 内 容 , 否 则 显示 客户 页 提 
供 的 具体 内 容 。 

代码 清单 10-3 ”模板 页 (template/template_one. xhtml) 


1.<?xml version='1.0' encoding= 'UTF-8' ?> 


2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 


3. "http://www.w3.0org/TR/xhtmll/DTD/xhtmll-transitional.dtd"> 

4. <html xmlns="http://www.w3.0rg/1999/xhtml" 

5 xmlns:ui="http://java.sun.com/jsf/facelets" 

6. xmlns:h="http://java.sun.com/jsf/html"> 

7 <h:head> 

8 <h:outputStylesheet library="css" name="layout.css"/> 

9 <h:outputStylesheet library="css" name="default.css"/> 
10 . <title>Facelets Template 1 </title> 


11. </h:head> 
12. <h:body> 


3 <div id="top"> 

14. <ui:insert name="top">DefaultTop</ui:insert> 

15, </div> 

16. <div id="content"> 

17。 <ui:insert name="content">DefaultContent</ui:insert> 
18. </div> 

19 。 <div id="bottom"> 

20. <ui:insert name="bottom">DefaultBottom</ui:insert> 
21, </div> 


22. </h:body> 
23. </html> 
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该 模板 页 使 用 了 两 个 层 琵 样式 表 , 即 layout. css 和 default. css。 这 两 个 样式 表 都 存放 
在 应 用 文档 根 目 录 下 的 resources/css 子 目录 下 。 代 码 清单 10-4 和 代码 清单 10-5 列 出 它们 
定义 的 样式 。 

代码 清单 10-4 用 于 布局 的 样式 (layout. css) 


.#top { 
position: relative; 
background-color: #036fab; 


color: white; 


margin: Opx Opx 10px Opx; 
. #bottom { 


9. position: relative; 


E 
2 
3 
4 
5. padding: 5px; 
6 
7 
8 


10. background-color: #c2dfef; 
11l. padding: 5px; 

12. margin: 10px Opx Opx Opx; 
135 } 

14.#content { 

15. position: relative; 

16. background-color: #dddddd; 
17. padding: S5px; 

18.} 


代码 清单 10-5 ”默认 的 样式 (default. css) 


1. body { 

2 background- color: #ffffff; 
3 font-size: 14px; 

4. color: #000000; 

5 margin: 10px; 

6 


.} 


接 下 来 介绍 客户 页 。 在 这 种 方式 中 ,客户 页 主要 为 模板 页 中 由 ui:insert 标记 定义 的 节 
提供 具体 的 内 容 。 代 码 清单 10-6 给 出 了 该 示例 的 客户 页 。 
代码 清单 10-6 ”客户 页 (client_one. xhtml) 


.<?xml version='1.0' encoding= 'UTF-8' ?> 

.<“!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0org/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 

.<html xmlns="http://www.w3.0rg/1999/xhtml" 


xmlns:ui="http://java.sun.com/jsf/facelets" 


1 
2 
3 
4 
3 
6. xmlns:h="http://java.sun.com/jsf/html"> 
2 <body> 

8 <ui:composition template="template/template one.xhtml"> 

9 <ui:define name="top"> 

0 <h:outputStylesheet library="css" name="css one.css"/> 
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ls <div class="top"> 


i 页 头 

Ys </div> 

14. </ui:define> 

15% <ui:define name="content"> 
16% <ui:include src="section\login.xhtml"/> 
76 </ui:define> 

18. <ui:define name="bottom"> 
Ls <div class="bottom"> 

20. 页 脚 

是 下 </div> 

22: </ui:define> 

3 </ui:composition> 

24. </body> 

25. </html> 


在 客户 页 中 ,为 模板 页 中 的 节 提 供 的 具体 内 容 应 包含 在 ui: define 标记 内 。ui: define 标 
记 的 name 属性 指定 为 哪个 节 提 供 内 容 , 即 该 属性 值 应 与 模板 页 中 的 某 个 ui:insert 标记 的 
name 属性 值 相 匹配 。 

在 客户 页 中 ,所 有 的 ui:define 标记 都 必须 租 套 于 带 template 属性 的 ui:composition 标 
记 。 当 JSF 框架 处 理 客户 页 的 ui:composition 标记 时 ,首先 会 丢弃 标记 外 的 内 容 , 然 后 装 人 
template 属性 指定 的 模板 页 ,最 后 用 客户 页 中 各 ui:define 标记 内 的 内 容 蔡 换 模板 页 中 对 应 
的 ui:insert 标记 、 形 成 最 终 的 视图 页 面 。 

该 示例 中 ,客户 页 为 名 称 为 content 的 节 提 供 的 具体 内 容 实际 定义 在 一 个 节 内 容 页 中 ， 
客户 页 通过 ui:include 标记 把 它 包含 进来 。 该 节 内 容 页 的 代码 见 代码 清单 10-7 。 

代码 清单 10-7 节 内 容 页 (section/login. xhtml) 


,<?xml version='1.0' encoding= 'UTF-8' ?> 

.<“!DOCTYPE html PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.0rg/TR/xhtml1l/DTD/xhtmll-transitional.dtd"> 

.<html xmlns="http://www.w3.0rg/1999/xhtml" 


1 
2 
3 
4 
5 xmlns:h="http://java.sun.com/jsf/html" 
6 xmlns:ui="http://java.sun.com/jsf/facelets"> 
2 <h:head> 

8 <title>login</title> 

9. </h:head> 


10. <h:body> 


和 <ui:composition> 

2 <h:form> 

3 <h:outputLabel for="name" value=" 用 户 名 "/> 
lL <h:inputText id="name"/> 

5 <p/> 

16. <h:outputLabel for="pw" value=" 密 码 "/> 
7 <h:inputSecret id="pw"/> 

18. <p/> 
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19, <h:commandButton value="OK"/> 
20 . </h:form> 

性 </ui:composition> 

22. </h:body> 

23. </html> 


ui:include 标记 不 仅 可 以 用 于 普通 的 JSF 页 (包含 页 )、 客 户 页 ,也 可 用 于 模板 页 ,比如 
可 以 在 模板 页 的 ui:insert 标记 内 用 ui:include 标记 装 和 该 节 的 默认 内 容 。 

该 示例 中 ,客户 页 也 使 用 了 一 个 层 径 样式 表 . 即 css_one. css( 代 码 清单 10-8) 。 该 样式 
表 也 存放 在 应 用 文档 根 目录 下 的 resources/css 子 目录 下 ,其 定义 的 样式 主要 用 于 页 头 和 页 
脚 的 显示 ,可 以 覆盖 模板 中 已 定义 的 默认 样式 。 

代码 清单 10-8 ”客户 页 定义 的 样式 (css_one. css) 


lstop { 

过 text-align: center; 
3 font-size: 36px 
4.1 

5. .bottom { 
6 text-align: center; 
font-size: 12px 

8 


.} 


说 明 : 在 该 示例 的 客户 页 中 ,把 链接 层 释 样式 表 的 二 h:outputStylesheet 二 标记 放置 在 
某 个 二 ui: define 二 标记 内 的 原因 是 : 模板 页 中 只 定义 了 有 名 的 节 , 这 样 JSF 在 处 理 客户 页 
时 ,就 只 处 理 二 ui: define 二 标记 内 的 内 容 , 而 不 会 处 理 二 ui: composition 记 标记 内 、 三 ui: 
define 之 标记 外 的 内 容 。 
模板 页 客户 页 和 节 内 容 页 都 是 xhtml 文件 ,可 以 像 普通 JSF 页 一 样 来 创建 ,并 存放 在 
应 用 的 文档 根 目录 或 某 个 子 目 录 下 。 比 如 为 便于 管理 ,将 模板 页 存放 在 template 子 目 录 
下 ,将 节 内 容 页 存放 在 section 子 目 录 下 等 。 
对 基于 模板 页 创建 视图 页 面 的 方式 ,NetBeans IDE 提供 了 专门 的 命令 ,可 以 帮助 用 户 
更 加 方便 地 创建 模板 页 和 客户 页 。 
。 创建 一 个 指定 布局 样式 的 模板 页 : 
新 建文 件 |JavaServer Faces|Facelets 模板 。 
。 创建 一 个 使 用 指定 模板 页 的 客户 页 : 
新 建文 件 |JavaServer Faces|Facelets 模板 客户 端 。 


10.2.2 基于 客户 页 创建 视图 页 面 


分 内 容 。 模 板 页 可 用 于 装饰 客户 页 中 指定 的 内 容 。 


下 面 通 过 示例 说 明 如 何 采用 该 种 方式 使 用 Facelets 模板 特性 ,其 中 涉及 的 文件 都 存在 
于 ch10_includeAndTemplate 应 用 项 目 。 有 些 文件 与 10. 2. 1 节 所 举 示 例 的 文件 完全 相同 ， 
下 面 不 再 列 出 。 当 用 户 请 求 客户 页 (client_two. xhtml) 时 呈现 的 响应 也 与 10. 2. 1 节 所 举 示 
例 的 呈现 响应 相同 ,如 图 10-2 所 示 。 

先 来 看 客户 页 (代码 清单 10-9)。 可 以 设想 客户 页 本 来 仅 包含 一 个 表单 ,现在 需要 为 其 
添加 一 个 页 头 和 页 脚 ,并 可 对 表单 的 显示 引入 某 些 额 外 的 样式 。 为 此 ,可 以 定义 一 个 模板 页 
(template_two. xhtml) ,模板 页 中 包含 有 页 头 、 页 脚 以 及 相关 的 样式 表 , 然 后 在 客户 页 中 用 
ui. decorate 标记 引用 模板 页 ,让 模板 页 来 装饰 客户 页 原 有 的 内 容 , 即 表单 。 

代码 清单 10-9 客户 页 (client_two. xhtml) 


1.<?xml version='1.0' encoding= 'UTE-8' ?> 
2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
3. "http://www.w3.0org/TR/xhtml1l/DTD/xhtmll-transitional.dtd"> 
<html xmlns="http://www.w3.0rg/1999/xhtml" 
xmlns:h="http://java.sun.com/jsf/html" 
xmlns:ui="http://java.sun.com/jsf/facelets"> 
<h:head> 


<h:outputSstylesheet library="css" name="default.css"/> 


oO oJ wm 心 


<title>Facelets Template 2</title> 
10. </h:head> 
11l. <h:body> 


2 <ui:decorate template="template\template two.xhtml"> 
13 。 <h:form> 

14. <h:outputLabel for="name" value=" 用 户 名 "/> 
5 <h:inputText id="name"/> 

16. <p/> 

Eh <h:outputLabel for="pw" value=" 密 码 "/> 
18. <h:inputSecret id="pw"/> 

19. <p/> 

20. <h:commandButton value= "OK"/> 

2 </h:form> 

22. </ui:decorate> 

23. </h:body> 

24. </html> 


在 这 种 方式 中 ,虽然 形成 最 终 视 图 页 面 的 基础 是 客户 页 ,但 形成 客户 页 中 ui: decorate 
标记 最 终 呈 现 内 容 的 基础 是 模板 页 。 接 下 来 看 模板 页 (代码 清单 10-10)。 在 这 里 ,模板 内 
容 实际 定义 于 模板 页 的 ui:composition 标记 内 ,其 中 包含 三 个 节 ( 由 ui:insert 标记 定义 )， 
第 1 个 节 和 第 3 个 节 的 名 称 分 别 为 top 和 bottom, 并 都 提供 了 默认 内 容 , 第 2 个 节 没 有 名 
称 , 也 没有 定义 默认 内 容 。 

代码 清单 10-10 ”模板 页 (templat_two. xhtml) 


1. <?xml version='1.0' encoding='UTF-8' ?> 
2. <!DOCTYPE html PUBLIC "~-//W3C//DTD XHTML 1.0 Transitional//EN" 
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3 "http://www.w3.0rg/TR/xhtml1/DTD/xhtmll-transitional.dtd"> 
4. <html xmlns="http://www.w3.0rg/1999/xhtml" 

和 xmlns:h="http://java.sun.com/jsf/html" 

6. xmlns:ui="http://java.sun.com/jsf/facelets"> 

7 <h:head> 

8 <title>Facelet Title</title> 

9 </h:head> 


10. <h:body> 


Ls, <ui:composition> 

2 <h:outputStylesheet library="css" name="layout.css"/> 
EE <h:outputStylesheet library="css" name="css one.css"/> 
14. <ui:insert name="top"> 

L5s <div id="top" class="top"> 

16. 页 头 

Is </div> 

18. </ui:insert> 

19. <div id="content"> 

20. <ui:insert/> 

21s </div> 

22. <ui:insert name="bottom"> 

23 <div id= "bottom" class="bottom"> 

24. 页 脚 

25s </div> 

26. </ui:insert> 

Es </ui:composition> 

28. </h:body> 

29. </html> 


当 JSF 框架 处 理 客户 页 的 ui: decorate 标记 时 ,将 读 取 指定 模板 页 中 ui:composition 标 
记 内 的 内 容 ( 标 记 外 的 内 容 被 丢弃 ) ,并 以 此 为 基础 形成 客户 页 ui: decorate 标记 最 终 要 呈现 
的 内 容 。 如 果 客 户 页 ui:decorate 标记 内 有 ui:define 标记 , 则 其 内 容 将 代替 模板 页 中 相应 
的 ui:insert 标记 定义 的 节 的 默认 内 容 。 本 示例 不 存在 这 样 的 ui:define 标记 ,所 以 模板 页 中 
定义 的 top 节 和 bottom 节 都 将 呈现 其 默认 内 容 。 

在 该 示例 中 ,模板 页 中 无 名 节 的 定义 , 即 二 ui:insert/ 这 ,显得 尤为 重要 。 如 果 没 有 定义 
该 无 名 节 ,那么 客户 页 中 ui:decorate 标记 中 原先 的 内 容 ( 即 表单 ) 将 不 会 出 现在 最 终 视图 
中 。 而 一 旦 定义 了 无 名 节 , 那 么 客户 页 ui: decorate 标记 内 、ui: define 标记 外 的 所 有 内 容 就 
会 作为 模板 页 中 定义 的 无 名 节 要 呈现 的 内 容 。 


10.3 ui:param 与 ui:repeat 


这 里 介绍 Facelets 标记 库 的 另外 两 个 标记 : ui:param 与 ui:repeat。 
10.3.1 ui:param 标记 


在 包含 特性 和 模板 特性 中 , 节 内 容 页 和 模板 页 作为 可 重用 的 语法 成 分 ,通常 会 在 多 处 被 
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调用 。 为 增强 其 通用 性 ,Facelets 允许 包含 页 向 节 内 容 页 ,客户 页 向 模板 页 传递 参数 。 
包含 页 和 客户 页 通过 ui:param 标记 向 节 内 容 页 和 模板 页 传递 参数 ,此 时 该 标记 应 该 作 
为 ui:include 标记 、 带 template 属性 的 ui:composition 和 ui:decorate 标记 的 子 标记 。 
ui:param 标记 有 两 个 属性 ,name 属性 指定 参数 名 ,value 属性 指定 参数 值 。 比 如 下 面 
是 包含 页 的 一 段 代码 : 


<ui:include src= .....- > 
<ui:param name="currentDate" value="# {myBean.currentDate}"/> 
<ui:include/> 


被 传递 的 参数 作为 一 个 EL 变量 ,可 以 用 于 节 内 容 页 .模板 页 中 的 EL 表达 式 中 。 比 如 ， 
下 面 是 节 内 容 页 的 一 段 代 码 : 


<div class="cl"> 
Today's date: #{currentDate} 
</div> 


10.3.2 ui:repeat 标记 


与 h:dataTable 标记 相似 ,ui:repeat 标记 也 能 对 数组 或 表 中 的 元 素 进行 迭代 处 理 。 相 
比 两 者 ,h:dataTable 标记 适合 将 数组 或 表 中 的 数据 呈现 成 数据 表格 ,而 ui:repeat 标记 则 可 
以 更 自由 或 自主 地 去 呈现 数组 或 表 中 的 数据 。 

下 面 代码 演示 了 ui:repeat 标记 的 用 法 。 其 中 ,value 属性 通过 EL 表达 式 指向 该 标记 
要 和 迭代 处 理 的 数组 或 表 , 这 里 假设 books 是 受 管 bean 中 类 型 为 List 二 Book 二 的 属性 。var 
属性 暴露 一 个 变量 ,表示 当前 被 迭代 处 理 的 元 素 。 


<ui:repeat value="#{myBean.books}" var="book"> 
<p> 
<h:outputText value=" 书 名 "/> 
<h:outputText value="#{book.title}"/><br/> 
<h:outputText value=" 作 者 "/> 
<h:outputText value="#{book.author}"/><br/> 
<h:outputText value=" 出 版 社 "/> 
<h:outputText value="#{book.publisher}"/> 
</p> 


</ui:repeat> 


除了 value 和 var 属性 ,ui:repeat 标记 还 包含 以 下 属性 ,允许 迭代 人 处理 数组 或 表 的 子 集 。 

。 offset: 和 迭代 处 理 的 首 元 素 的 索引 ,默认 值 为 0。 

。 step: 步 长 。 默 认 值 为 1, 即 连续 处 理 各 元 素 。 

。 size: 迭代 处 理 的 尾 元 素 的 索引 ,默认 值 为 数组 或 表 中 最 后 一 个 元 素 的 索引 。 

例如 ,books 表 的 大 小 为 10(10 个 元 素 的 索引 依次 为 0.1,2,…,9), 那 么 下 面 标记 会 迭 
代 处 理 的 元 素 的 索引 应 包括 : 3、5、7。 


<ui:repeat value="#{myBean.books}" var="book" offset="3" step="2" size="8"> 


。234。 


另外 ,ui:repeat 标记 的 varStatus 属性 暴露 一 个 变量 ,该 变量 指向 一 个 对 象 ,对 象 包含 
一 组 只 读 的 表示 和 迭代 状态 的 JavaBean 属性 。 表 10-1 列 出 了 这 些 JavaBean 属性 。 


表 10-1 表示 和 迭代 状态 的 JavaBean 属性 


JavaBean 属性 含 光 类 型 
index 当前 元 素 在 数组 或 表 中 的 索引 int 
begin 对 应 标记 的 offset Integer 
end 对 应 标记 的 size Integer 
step 对 应 标记 的 step Integer 
even 当前 元 素 是 否 为 第 偶数 个 被 迭代 的 元 素 boolean 
odd 当前 元 素 是 否 为 第 奇数 个 被 迭代 的 元 素 boolean 
first 当前 元 素 是 否 是 第 一 个 被 迭代 的 元 素 boolean 
last 当前 元 素 是 否 是 最 后 一 个 被 迭代 的 元 素 boolean 


例如 ,下 面 标记 在 呈现 每 本 图 书 时 ,会 先 显示 该 图 书 在 表 或 数组 中 的 索引 。 


<ui:repeat value="#{myBean.books}" var="book" varStatus="status"> 
#{status.index}<br/> 


</ui:repeat> 


10.4 创建 复合 组 件 


与 普通 的 JSF 页 一 样 ,复合 组 件 也 是 一 个 XHTML 文件 , 称 为 复合 组 件 页 。 每 个 复合 
组 件 页 定义 一 个 复合 组 件 。 复合 组 件 页 应 放置 在 应 用 文档 根 目录 下 的 resources 子 目录 下 
的 某 个 子 目 录 中 ,如 ezcomp, 这 个 子 目录 被 看 作 是 一 个 复合 组 件 库 。 

在 NetBeans IDE 中 ,可 以 调用 以 下 命令 创建 一 个 复合 组 件 : 


新 建文 件 luavaServer Faces1JSF 复合 组 件 


复合 组 件 的 定义 包括 接口 和 实现 两 部 分 。 实 现 定义 于 cc:implementation 标记 内 ,通常 
是 根据 需要 由 一 些 标准 的 或 现 有 的 JSF 标记 组 合 而 成 。 接 口 定义 于 cc:interface 标记 内 ， 
用 于 向 用 户 公开 该 复合 组 件 的 用 法 、 可 配置 属性 等 。 

下 面 通过 一 个 有 关 登 录 复 合 组 件 的 示例 说 明 复 合 组 件 的 定义 、 使 用 等 技术 。 该 示例 的 
完整 代码 保存 在 应 用 项 目 ch10_compositedemo 中 。 

代码 清单 10-11 列 出 登录 复合 组 件 的 定义 ,其 实现 定义 主要 由 组 成 登录 表单 的 一 些 标 
准 的 JSF 标记 组 合 而 成 。 该 文件 保存 在 resources 目录 下 的 ezcomp 子 目 录 中 。 

代码 清单 10-11 登录 复合 组 件 (login. xhtml) 基 本 版 


1.<?xml version='1.0' encoding= 'UTEF-8' ?> 
2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
3. "http://www.w3.0rg/TR/xhtmll/DTD/xhtmll-transitional.dtd"> 
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4. <html xmlns="http://www.w3.0rg/1999/xhtml" 
5 xmlns:cc="http://java.sun.com/jsf/composite" 
6. xmlns:h="http://java.sun.com/jsf/html"> 
2 <cc:interface/> 
8 <cc:implementation> 
和 <p> 
10. 请 登录 
Es </p> 
12. <h:form id="form"> 
3 <h:panelGrid columns="2"> 
14. 用 户 名 
V5e <h:panelGroup> 
346。 <h:inputText id="name" value="# {myBean.name}" required="true"/> 
17. <h:message for="name"/> 
18. </h:panelGroup> 
19. 密码 
205 <h:panelGroup> 
a <h:inputSecret id="pw" value="# {myBean.password}" required="true"/> 
本 <h:message for="pw"/> 
3 </h:panelGroup> 
24. </h:panelGrid> 
25， <P> 
26， <h:commandButton id="button" value=" 登 录 " action="#{myBean.action}"/> 
"人 </p> 
28. </h:form> 
29. </cc:implementation> 
30. </html> 


这 是 登录 复合 组 件 定义 的 基本 版 ,没有 提供 任何 可 配置 的 属性 。 这 里 主要 是 为 了 说 明 
复合 组 件 的 定义 过 程 、 组 成 和 使 用 等 ,关于 复合 组 件 定义 的 更 多 内 容 会 在 后 面 陆续 介绍 。 

说 明 : 在 上 述 定义 中 ,过 cc:interface 二 标记 虽然 没有 指定 任何 属性 ,也 没有 包含 任何 子 
标记 ,但 该 标记 本 身 不 能 缺 省 。 

定义 好 了 复合 组 件 ,就 可 以 在 普通 的 JSF 页 面 中 使 用 复合 组 件 。 要 使 用 复合 组 件 , 需 
要 在 JSF 页 中 声明 复合 组 件 库 的 名 称 空 间 , 例 如 : 


xmlns:ezcomp="http://java.sun.com/jsf/composite/emcomp" 


名 称 空间 的 值 必须 以 http://java. sun. com/jsf/composite/ 开 头 , 其 余 的 内 容 必 须 与 复 
合 组 件 库 对 应 的 子 目 录 名 一 致 。 可 以 为 名 称 空间 指定 任意 名 称 , 但 通常 取 复 合 组 件 库 对 应 
的 子 目 录 名 ,如 ezcomp。 

代码 清单 10-12 演示 了 如 何 使 用 登录 复合 组 件 。 

代码 清单 10-12 ”使 用 登录 复合 组 件 (index. xhtml) 


1.<?xml version='1.0' encoding= 'UTEF-8' ?> 

2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 

3. "http://www.w3.0rg/TR/xhtmll1/DTD/xhtmll-transitional.dtd"> 
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<html xmlns="http://www.w3.0rg/1999/xhtml" 
xmlns:h="http://java.sun.com/jsf/html" 


EE 
5 
6. xmlns:ezcomp="http://java.sun.com/jsf/composite/ezcomp"> 
席 <h:head> 

8 <title>composite demo</title> 

9 </h:head> 


10. <h:body> 


Ys <ezcomp:login/> 
12. </h:body> 
13. </html> 


10.5 配置 复合 组 件 


复合 组 件 作 为 一 种 可 重用 的 软件 成 分 应 该 是 可 配置 的 ,以 便 能 在 不 同 的 场合 被 方便 而 
又 恰当 地 使 用 。 上 述 登 录 复 合 组 件 的 定义 显然 并 不 理想 ,因为 所 有 内 容 都 是 固定 而 不 可 配 
置 的 。 例 如 ,要 使 用 这 个 复合 组 件 , 必 须 存 在 相应 的 名 为 myBean 的 受 管 bean, 其 中 定义 了 
可 读 写 的 name 属性 和 password 属性 ,以 及 一 个 名 为 action 的 动作 方法 。 
可 以 在 复合 组 件 的 接口 定义 中 为 复合 组 件 声明 相应 的 属性 ,然后 在 复合 组 件 的 实现 定 
义 中 利用 这 些 属 性 来 编写 复合 组 件 的 相关 内 容 , 而 在 使 用 复合 组 件 时 再 为 这 些 属 性 指定 具 
体 的 值 。 显 而 易 见 ,这 样 的 复合 组 件 是 可 配置 的 ,具有 更 好 的 可 重用 性 。 
用 cc:attribute 标记 声明 复合 组 件 的 属性 ,该 标记 只 能 用 于 cc:interface 标记 内 。 也 就 
是 说 ,应 该 在 复合 组 件 的 接口 定义 中 声明 复合 组 件 的 属性 。 下面 是 cc:attribute 标记 的 一 
。 name: 为 定义 属性 指定 属性 名 。 
。 required: 指明 在 使 用 复合 组 件 时 是 否 必须 为 定义 属性 指定 值 。 
。 default: 为 定义 属性 指定 一 个 默认 值 。 
。 type: 指定 定义 属性 必须 指向 一 个 值 表达 式 ,该 属性 指定 值 表达 式 的 类 型 。 
。 method-signature: 指定 定义 属性 必须 指向 一 个 方法 表达 式 ,该 属性 指定 方法 表达 式 
的 签名 。 这 里 ,方法 签名 应 包括 方法 返回 类 型 .方法 名 和 形 参 。 返 回 类 型 和 形 参 类 
型 可 以 是 基本 类 型 也 可 以 是 引用 类 型 ,如 果 是 引用 类 型 ,应 给 出 完整 类 名 。 方 法 名 
可 以 是 一 个 任意 的 别名 ,在 使 用 复合 组 件 、 设 置 属性 时 ,再 指定 具体 的 方法 名 。 
如 果 type 和 method-signature 属性 都 没有 指定 , 则 一 般 认 为 定义 属性 值 是 一 个 值 表达 
式 , 其 类 型 为 java. lang. Object。 如 果 两 个 属性 都 指定 了 , 则 method-signature 属性 被 忽略 。 
一 旦 声明 了 属性 ,在 复合 组 件 的 实现 定义 中 就 可 以 通过 EL 表达 式 引 用 这 些 属 性 。 引 
用 属性 的 一 般 格式 为 : # {cc. attrs. 到 属性 名 之 } 。 其 中 cc 表示 当前 复合 组 件 ,aatrs 表示 该 
复合 组 件 的 属性 集 。 
代码 清单 10-13 给 出 了 可 配置 的 登录 复合 组 件 的 定义 ,文件 名 为 login_1. xhtml。 除 用 
户 名 文本 域 组 件 的 值 .口令 域 组 件 的 值 和 动作 按钮 的 动作 方法 ,表单 标题 ,文本 域 标签 .口令 
域 标 签 和 按钮 标题 都 是 可 配置 的 。 
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代码 清单 10-13 ”可 配置 的 登录 复合 组 件 定义 (login_1. xhtml) 


Ye 
2 
3 
4 
5. 
6 
学 
8 


9 . 
10 . 
11. 
12. 
13. 
14. 
15 . 
16 . 
17。 
18 . 
19. 
20. 
21. 
22. 
23. 
24. 
25.。 
26. 
27。 
28 . 
29. 
30 . 
31, 
32 
33, 
34. 
35， 
36。 
37 。 


<html xmlns="http://www.w3.0rg/1999/xhtml" 
xmlns:cc="http://java.sun.com/jsf/composite" 
xmlns:h="http://java.sun.com/jsf/html"> 


<cc:interface> 


<cc:attribute name="formTitle" default="Please Log in"/> 
<cc:attribute name="namePrompt" default="Username"/> 
<cc:attribute name="pwPrompt" default="Password"/> 
<cc:attribute name="buttonTitle" default="Login"/> 
<cc:attribute name="name" required="true"/> 
<cc:attribute name="password" required="true"/> 
<cc:attribute name="loginAction" method- signature="java.lang.string m()" 
required="true"/> 
</cc:interface> 
<cc:implementation> 
<p> 
#{cc.attrs.formTitle} 
</p> 
<h:form id="form"> 
<h:panelGrid columns="2"> 
#{cc.attrs.namePrompt} 
<h:panelGroup> 
<h:inputText id="name" value="#{cc.attrs.name}" required="true"/> 
<h:message for="name"/> 
</h:panelGroup> 
#{cc.attrs.pwPrompt} 
<h:panelGroup> 
<h:inputSecret id="pw" value="#{cc.attrs.password}" required="true"/> 
<h:message for="pw"/> 
</h:panelGroup> 
</h:panelGrid> 
<p> 
<h:commandButton id="button" value="#{cc.attrs.buttonTitle}" 
action="#{cc.attrs.loginAction}"/> 
</p> 
</h:form> 
</cc:implementation> 
</html> 


现在 ,页 面 制作 者 可 以 更 加 灵活 地 使 用 该 登录 复合 组 件 了 。 其 中 ,name 属性 password 
属性 和 loginAction 属性 是 必需 的 ,使 用 者 可 以 根据 具体 的 情况 为 它们 指定 合适 的 值 表达 式 
和 方法 表达 式 。 其 他 属性 是 可 选 的 ,但 在 声明 时 都 为 它们 指定 了 各 自 的 默认 值 。 下 面 代码 
是 使 用 该 登录 复合 组 件 的 一 个 示例 。 


<ezcomp:login 1 name="#{myBean.name}" password="#{myBean.password}" 
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loginAction="#{myBean.action}"/> 


10.6 公开 复合 组 件 


可 以 为 复合 组 件 注册 所 需 的 转换 器 、 验 证 器 或 事件 监听 器 ,但 这 些 转换 器 、 验 证 器 等 总 
是 针对 复合 组 件 中 的 某 个 组 件 的 ,而 不 大 可 能 是 为 整个 复合 组 件 服务 的 。 例 如 ,可 以 为 登录 
复合 组 件 注册 一 个 验证 器 用 以 验证 其 中 的 密码 是 否 正确 ,可 以 为 该 复合 组 件 注册 一 个 动作 
事件 监听 器 用 以 监听 登录 按钮 引发 的 动作 事件 等 。 

一 种 方法 是 在 复合 组 件 的 实现 定义 中 ,为 复合 组 件 中 的 某 个 组 件 注册 适当 的 转换 器 、 验 
证 器 或 事件 监听 器 ,但 这 种 方式 较为 死板 ,是 不 可 配置 的 。 较 为 灵活 的 方式 应 该 是 在 使 用 复 
合 组 件 时 ,决定 是 否 为 某 组 件 注册 转换 器 、 验 证 器 或 事件 监听 器 ,以 及 注册 何 种 转换 器 、 验 证 
器 和 事件 监听 器 。 要 做 到 这 一 点 ,必须 先 公开 复合 组 件 中 的 相关 组 件 。 通 过 公开 复合 组 件 
中 的 组 件 ,页 面 制作 者 就 可 以 在 使 用 复合 组 件 时 针对 其 中 的 某 个 具体 组 件 注册 相关 的 转换 
器 、 验 证 器 或 事件 监听 器 。 

公开 复合 组 件 属于 使 用 复合 组 件 的 约定 的 范畴 ,要 在 复合 组 件 的 接口 定义 中 进行 。 下 
面 标记 用 于 公开 复合 组 件 中 某 种 类 型 的 组 件 。 

。 cc:editableValueHolder: 公开 EditableValueHolder 型 组 件 ,如 输入 类 组 件 。 

。 cc:valueHolder: 公开 ValueHolder 型 组 件 , 如 输入 类 组 件 、 输 出 类 组 件 。 

。 cc:actionSource; 公开 ActionSource 型 组 件 ,如 动作 按钮 ,动作 超 链接 等 。 

上 述 标记 都 有 两 个 属性 : name 和 targets。 其 中 targets 属性 指定 要 公开 的 组 件 的 客户 
端 标识 符 。 可 以 指定 多 个 组 件 的 客户 端 标 识 符 , 此 时 各 标识 符 之 间 用 空格 分 隔 。name 属性 
为 公开 的 一 个 或 多 个 组 件 指定 一 个 名 称 。 使 用 复合 组 件 时 ,可 以 通过 该 名 称 为 相应 的 组 件 
注册 所 需 的 转换 器 等 。 

代码 清单 10-14 给 出 了 新 的 登录 复合 组 件 的 定义 ,其 文件 名 为 login_2. xhtml。 与 上 一 
个 版 本 相 比 , 它 仅 在 接口 定义 中 增加 了 三 行 ,用 于 公开 相关 组 件 。 

代码 清单 10-14 ”新 版 登录 复合 组 件 定义 (login_2. xhtml) 


1. <html xmlns="http://www.w3.0rg/1999/xhtml" 

内 xmlns:cc="http://java.sun.com/jsf/composite" 

3 xmlns:h="http://java.sun.com/jsf/html"> 

4 <cc:interface> 

ET 

6 <cc:editableValueHolder name="nameInput" targets="form:name"/> 
<cc:editableValueHolder name="passwordInput" targets="form:pw"/> 

8 <cc:editableValueHolder name="inputs" targets="form:name form:pw"/> 
9. </cc:interface> 


10. <cc:implementation> 


12. </cc:implementation> 
13. </html> 
这 里 ,nameInput 是 用 户 名 文本 域 的 公开 名 称 , passwordInput 是 口令 域 的 公开 名 称 , 而 
inputs 则 同时 表示 上 述 两 个 组 件 。 
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现在 ,页 面 制作 者 可 以 在 使 用 登录 复合 组 件 时 ,为 这 些 输入 类 组 件 注册 所 需 的 转换 器 、 
验证 器 了 。 下 面 代 码 是 使 用 该 登录 复合 组 件 的 一 个 示例 ,其 中 为 用 户 名 文本 域 和 口令 域 注 
册 了 相关 的 验证 器 。 注 册 标 记 中 的 for 属性 指定 目标 组 件 的 公开 名 称 , 即 要 与 公开 复合 组 
件 标记 中 的 name 属性 值 相 匹 配 。 


<ezcomp:login 2 name="#{myBean.name}" 


password="# {myBean.password}" 


loginAction="# {myBean.action}"> 


<f:validateLength maximum="15" for="inputs"/> 


<f:validateLength minimum="4" for="nameInput"/> 


<f:validator validatorId="pwValidator" for="passwordInput"/> 


</ezcomp:login 2> 


注册 的 两 个 长 度 验证 器 规定 : 用 户 名 和 密码 最 多 输入 15 个 字符 ;用 户 名 至 少 输入 4 个 


字符 。 注 册 的 第 三 个 验证 器 是 一 个 自 定义 验证 器 ,用 于 验证 密码 值 是 否 正 确 。 代 码 清 
单 10-15 列 出 了 该 自 定义 验证 器 的 代码 ,其 功能 是 确保 密码 只 能 由 数字 和 字母 组 成 。 
代码 清单 10-15 ”验证 器 (PasswordValidator. java) 


. import 
. import 
. import 
. import 
. import 


. import 


javax. 
javax. 
javax. 
javax. 
javax. 


javax. 


. Package validator; 


faces .application.FacesMessage; 
faces .component .UIComponent; 
faces .context .FacesContext7 
faces.validator.FacesValidator; 
faces.validator.Validator; 


faces .validator.ValidatorException; 


. @FacesValidator ("pwValidator") 


. Public class PasswordValidator implements Validator { 


public void validate (FacesContext context,UIComponent component,Object value) 


throws ValidatorException { 


StringBuilder sb=new StringBuilder((String)value); 


int i=0; 


while(i<sb.length()){ 


char c=Sb .charRt (i); 


if(!(Character.isDigit(c) IICharacter.isLetter(c)))1{ 
String s=" 密 码 中 包含 非 数字 、 字 母 "; 


FacesMessage msg=new FacesMessage (s,s); 


上 


throw new ValidatorException (msg) 7 


ER 


说 明 : 除了 注册 验证 器 标记 (f:validator 等 ) ,注册 转换 器 标记 (f:converter 等 ) 和 注册 
动作 监听 器 标记 (f:actionListener) 也 都 有 一 个 for 属性 。 如 果 使 用 for 属性 ,那么 这 些 注 册 
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标记 应 该 出 现在 复合 组 件 标记 内 ,for 属性 指定 复合 组 件 中 的 某 个 公开 的 组 件 。 


10.7 将 复合 组 件 打包 成 JAR 文件 


可 以 将 复合 组 件 打包 成 JAR 文件 ,以便 在 其 他 JSF 应 用 中 使 用 这 些 复合 组 件 。 复 合 组 
件 的 相关 文件 通常 包括 : 

。 存放 在 复合 组 件 库 目录 (如 ezcomp) 下 的 复合 组 件 定义 文件 (如 login_1. xhtml) ; 

。 复合 组 件 定义 用 到 的 层 释 样式 表 文 件 、 图 像 文 件 等 。 

这 些 文件 原本 都 应 存放 在 resources 目录 下 。 打 包 复 合 有 
组 件 时 ,resources 目录 及 其 下 面 的 与 复合 组 件 相关 的 文件 BB 局) Tri 
都 应 按 原先 的 位 置 放置 在 JAR 文件 中 的 META-INF 子 目 日 回 resourees 


录 下 ,如 图 10-3 所 示 。 hl 
按 以 下 步骤 可 以 将 复合 组 件 打包 成 JAR 文件 : | 硬 iiaogaizxea 
(1) 创建 一 个 空 的 工作 目录 ,然后 在 其 中 创建 META- 


图 10-3 打包 复合 组 件 文件 
INF 子 目录 ; 


(2) 将 resources 目录 、 复 合 组 件 库 以 及 相关 资源 (样式 表 等 ) 按 它们 原来 的 位 置 复制 到 
METE-INF 子 目 录 ; 

(3) 打开 DOS 命令 窗口 ,将 上 述 工作 目录 设置 为 当前 目录 ,然后 输入 以 下 jar 命令 产生 
JAR 文件 : jar -cvfM components. jar x*. *。 


10.8 小 结 


包含 页 可 以 利用 ui: include 标记 装 入 指定 的 节 内 容 页 。 节 内 容 页 也 是 一 个 

XHTML 文件 ,其 中 节 的 内 容 被 包含 在 ui:composition 标记 内 。 

使 用 Facelets 模板 技术 的 方式 有 两 种 : 基于 模板 页 创建 视图 页 面 和 基于 客户 页 创建 

视图 页 面 。 

在 基于 模板 页 创建 视图 页 面 方式 中 ,模板 页 是 形成 最 终 视图 页 面 的 基础 ,应 包含 一 

个 视图 页 面 应 该 有 的 各 部 分 内 容 , 只 是 有 些 节 的 内 容 可 由 客户 页 提供 。 

在 基于 客户 页 创建 视图 页 面 方式 中 ,客户 页 是 形成 最 终 视图 页 面 的 基础 ,应 包含 一 

个 视图 页 面 应 该 有 的 各 部 分 内 容 ,模板 页 可 用 于 装饰 客户 页 中 指定 的 内 容 。 

。 与 h:dataTable 标记 相似 ,ui:repeat 标记 也 能 对 数组 或 表 中 的 元 素 进行 迭代 处 理 。 
相 比 h:dataTable 标记 ,ui:repeat 标记 可 以 更 自由 或 自主 地 去 呈现 数组 或 表 中 的 
数据 。 

。 复合 组 件 也 是 一 个 XHTML 文件 , 称 为 复合 组 件 页 。 每 个 复合 组 件 页 定义 一 个 复 

合 组 件 , 包 括 接口 定义 和 实现 定义 两 部 分 。 

实现 定义 于 cc:implementation 标记 内 ,通常 是 根据 需要 由 一 些 标准 的 、 或 现 有 的 

JSF 标记 组 合 而 成 。 接 口 定义 于 cc:interface 标记 内 ,用 于 向 用 户 公 开 该 复合 组 件 

的 用 法 .可 配置 属性 等 。 

复合 组 件 能 够 被 定义 成 可 配置 的 ,使 得 使 用 者 可 以 为 复合 组 件 指定 相关 的 属性 ,或 
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功能 。 


2 
3 
4. 
5 


者 为 复合 组 件 的 某 个 组 成 组 件 指定 所 需 的 转换 器 、 验 证 器 或 事件 监听 器 等 。 


习 题 10 


.比较 ui:include 标记 、 带 template 属性 的 ui: composition 和 ui: decorate 标记 的 


.比较 ui:param 标记 与 f:param 标记 的 功能 。 
. 简 述 创建 复合 组 件 的 基本 过 程 和 方法 。 


何谓 公开 复合 组 件 ? 举例 说 明 公 开 复合 组 件 及 使 用 公开 的 信息 的 方法 。 


.利用 Facelets 模板 技术 为 应 用 项 目 sh6_lookandbuy( 第 6 章 习 题 6) 中 的 每 个 页 面 增 


加 所 需 的 页 头 和 页 脚 。 
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第 11 章 Java DB 与 实体 类 


本 章 主题 

。 Java DB 基本 操作 

。 基本 的 SQL 语句 

。 JPA 概述 

。 实体 类 

。 通过 数据 库 生 成 实体 类 

大 多 数 Web 应 用 都 离 不 开 数据 的 存储 和 访问 。 在 Java EE 中 ,JPA 是 数据 持久 层 的 标 
准 。 利 用 JPA, 一 个 Web 应 用 可 以 实现 数据 的 存储 、 访 问 、 更 新 和 删除 。 

JPA 技术 建立 在 JDBC 技术 之 上 。 对 不 同 的 数据 库 系统 需要 配置 不 同 的 JDBC 驱动 程 
序 , 但 对 于 应 用 程序 来 说 , 则 可 以 采用 统一 的 编程 接口 。 也 就 是 说 ,相同 的 程序 代码 在 不 同 
的 JDBC 驱动 程序 支持 下 ,可 以 访问 不 同 的 数据 库 系统 。 

JPA 的 内 容 主 要 涉及 实体 类 的 定义 、 实 体 管理 器 API 和 JPQL 等 三 方面 。 本 章 首先 简 
单 介绍 JDK 自 含 的 数据 库 管理 系统 Java DB, 然 后 介绍 实体 类 的 定义 及 相关 操作 。 有 关 实 
体 管理 器 API 和 JPQL 的 内 容 将 在 下 一 章 介 绍 。 


11.1 Java DB 


Java DB 源 于 Apache 软件 基金 会 (Apache Software Foundation，ASF) 名 下 的 Derby 
项 目 ,是 一 个 纯 Java 实现 、 开 源 的 数据 库 管理 系统 。Java DB 小 巧 但 功能 完备 ,支持 外 键 , 索 
引 、 视 图 、 触 发 器 、 存 储 过 程 、 事 务 处 理 等 大 部 分 数据 库 应 用 所 需 的 特性 。 

Java DB 是 Java SE 6 平台 的 组 成 部 分 ,Java 程序 员 不 再 需要 耗费 大 量 精力 安装 和 配置 
数据 库 管理 系统 ,就 能 进行 安全 、 易 用 、 标 准 、 并 且 免 费 的 数据 库 编 程 。NetBeans IDE 及 
Glassfish 同样 提供 了 对 Java DB 的 支持 。 


11.1.1 基本 操作 


在 NetBeans IDE 的 “服务 ”窗口 中 ,用 户 可 以 方便 地 进行 Java DB 数据 库 的 创建 ,连接 
和 执行 SQL 命令 等 操作 。 

1. 创建 数据 库 

在 “服务 ”窗口 中 ,有 一 个 “数据 库 ” 节 点 ,其 中 包含 “Java DB”、“ 了 驱动 程 序 ” 等 子 节点 。 右 
击 “Java DB” 节 点 ,选择 打开 的 快捷 菜单 项 ,可 以 启动 或 停止 Java DB 数据 库 服务 器 、 创 建 
Java DB 数据 库 以 及 设置 存放 数据 库 的 位 置 等 。 

设置 存放 数据 库 的 位 置 的 操作 步骤 如 下 。 

(1) 右 击 "Java DB” 节点 ,选择 “属性 "命令 ,打开 “Java DB 属性 ”对 话 框 。 

(2) 在 “数据 库 位 置 ”文本 域 中 输入 用 于 存放 数据 库 的 路 径 , 或 者 单 击 右 侧 的 “浏览 ” 按 
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钮 选择 相应 的 路 径 。 

(3) 单 击 “ 确 定 ”按钮 。 

创建 一 个 Java DB 数据 库 的 操作 步 又 如 下 : 

(1) 右 击 Java DB” 节点 ,选择 “创建 数据 库 ” 命 令 , 将 打开 “创建 Java DB 数据 库 ” 对 话 
框 ,如 图 11-1 所 示 。 


登 创建 Java DB 数据 库 


3 hmtam 


oubuye 


3 :Nbelx 


图 11-1 创建 Java DB 数据 库 


(2) 在 对 话 框 中 设置 数据 库 名 称 以 及 用 户 名 和 口令 。 在 这 里 , 单 击 “ 属 性 ”按钮 ,同样 会 
打开 “Java DB 属性 ”对 话 框 ,也 可 以 设置 存放 数据 库 的 位 置 。 

(3) 单 击 “ 确 定 ” 按 钮 

新 建 一 个 Java DB 数据 库 后 ,NetBeans IDE 会 自动 创建 一 个 该 数据 库 的 连接 节点 , 数 
据 库 连接 节点 是 “数据 库 ” 节 点 的 子 节点 。 每 个 连接 节点 包含 了 与 特定 数据 库 连 接 所 需要 的 
相关 信息 ,如 驱动 程序 名 称 ,数据 库 服务 器 所 处 的 主机 域名 、 端 口号 等 。 

2. 连接 数据 库 与 执行 SQL 语句 

NetBeans IDE 为 新 建 数 据 库 自动 创建 连接 节点 并 不 意味 着 与 该 数据 库 建 立 了 连接 。 
要 对 数据 库 进行 操作 ,首先 应 该 与 数据 库 建 立 连接 。 

建立 从 IDE 至 数据 库 的 连接 的 方法 是 : 右 击 相应 的 数据 库 连 接 节点 ,然后 在 打开 的 快 
捷 菜 单 中 选择 “连接 ”命令 。 若 连接 成 功 ,该 连接 节点 下 会 出 现 数据 库 的 架构 (又 称 模式 ) 节 
点 ,每 个 架构 节点 下 会 包含 “ 表 ”“ 视 图 ”和 “过 程 ”3 个 子 节点 。 

建立 数据 库 连 接 后 ,可 以 打开 “SQL 命令 ”窗口 ,实现 对 数据 库 的 操作 。 使 用 “SQL 命 
令 ” 窗 口 的 方法 如 下 : 

(1) 右 击 一 个 数据 库 连 接 节 点 或 该 节点 下 的 * 表 ” 子 节点 ,选择 “执行 命令 ”选项 ,将 打开 
“SQL 命令 ”窗口 ,如 图 11-2 所 示 。 该 窗口 一 般 显示 于 编辑 器 窗 格 内 。 


尼 导 因 网 加 性 - 虱 " 凤 已 史 区 他 卫生 | 刍 划 e a 


1| create schena loubuye; 


图 11-2” SQL 命令 窗口 


在 “SQL 命令 ”窗口 中 ,“ 连 接 " 下 拉 框 内 应 显示 要 操作 的 目标 数据 库 的 对 应 连接 。 
(2) 在 “SQL 命令 ”窗口 中 输入 一 条 或 多 条 SQL 语句 (各 语句 之 间 用 分 号 隔 开 ) 。 
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(3) 单 击 "运行 SQL 按钮 感 :执行 窗口 中 的 SQL 语句 。 

SQL 语句 执行 后 的 结果 信息 会 显示 在 “输出 "窗口 。 如 果 执 行 的 是 SELECT 语句 , 查 
询 结 果 将 显示 于 “SQL 命令 "窗口 的 下 方 。 

NetBeans IDE 自动 创建 的 数据 库 连接 节点 . 设 定 与 用 户 名 同名 的 架构 为 数据 库 的 缺 省 架 
构 。 如 果 该 缺 省 架构 不 存在 ,可 以 执行 下 面 SQL 语句 创建 之 ,其 中 schema-name 取 用 户 名 。 


CREATE SCHEMA schema- name 


虽然 右 击 某 架 构 节 点 ,然后 选择 “设置 为 缺 省 架构 ”命令 可 以 改变 数据 库 的 缺 省 架构 ,但 
数据 库 连 接 节点 中 设 定 的 缺 省 架构 是 不 会 改变 的 。 一 些 自动 工具 在 访问 数据 库 时 , 仅 会 列 
出 连接 节点 中 设 定 的 缺 省 架构 中 的 表 , 所 以 一 般 应 确保 连接 节点 中 设 定 的 缺 省 架构 在 数据 
库 中 是 存在 的 。 

3. 创建 数据 库 连接 节点 

右 击 数据 库 连接 节点 ,选择 “连接 ”命令 ,可 以 建立 与 数据 库 的 连接 。 建 立 连接 后 , 右 击 
连接 节点 ,选择 “执行 命令 ”选项 ,可 以 打开 SQL 命令 窗口 ,实现 对 数据 库 的 操作 ;选择 “ 断 开 
连接 ?选项 ,可 以 断 开 与 数据 库 的 连接 。 

在 未 建立 与 数据 库 连 接 的 状况 下 , 右 击 数据 库 连 接 节 点 ,选择 “删除 ”命令 ,可 以 删除 数 

当 需 要 建立 与 数据 库 的 连接 ,而 又 不 存在 相应 的 连接 节点 时 (如 原 有 的 连接 点 被 删除 ， 
或 一 个 数据 库 从 另外 一 个 计算 机 复制 过 来 ) ,可 以 按 下 面 步骤 创建 一 个 数据 库 连接 节点 并 建 
立 与 数据 库 的 连接 。 

(1) 碳 击 “数据 库 ? 节 点 ,在 打开 的 快捷 菜单 中 选择 “新 建 连接 ”命令 ,打开 “新 建 数 据 库 
连接 ?对 话 框 。 

(2) 设置 连接 数据 所 需 的 相关 属性 ,如 图 11-3 所 示 。 


基本 设置 | 高志 | 


数据 输入 模式 如 回 第 入 字段 中。 〇 直接 输入 VRLGD) 
驱动 程序 名 称 中 Java DB Oletwork) 国 
主机 加 ) : localhost 
端口 @): 1527 
数据 库 @) : untan 
用 户 各 中 : Loubuye 
OD$W: ooooe 
显示 名 称 ( 可 选 ) 0D) : 

口令 QQ | 
附加 属性 4) 
口 显 示 JPBC VEL 

Ce [am ] 


图 11-3 “新 建 数 据 库 连 接 ” 对 话 框 
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用 于 连接 Java DB 数据 库 的 驱动 程序 分 “Java DB(Embedded)” 和 “Java DB(Network)” 
两 种 。 在 Web 应 用 中 ,一 般 应 选择 网 络 型 驱动 程序 , 即 *Java DB(Network)”。 

主机 填 Java DB 数据 库 服 务 器 所 在 机 器 的 域名 。 若 为 本 地 ,可 填 localhost。Java DB 
数据 库 服 务 器 默认 端口 号 为 1527。 

数据 库 名 .用户 名 和 口令 应 填 在 创建 数据 库 时 采用 的 相关 属性 。 

选中 “ 记 住 口令 ” 复 选 框 ,让 数据 库 资源 管理 器 记 住 口 令 。 这 样 ,以 后 建立 数据 库 连 接 时 
就 不 会 被 要 求 输入 用 户 名 和 口令 了 。 

(3) 单 击 “ 确 定 ” 按 钮 ,在 打开 的 “高 级 "选项 卡 中 可 以 选择 一 个 缺 省 架构 。 

若 上 述 连接 操作 成 功 , 一 个 数据 库 连 接 节点 会 被 创建 ,同时 自动 建立 从 IDE 至 目标 数 
据 库 的 连接 。 


11.1.2 SQL 语句 


这 里 简单 介绍 Java DB 中 有 关 表 的 定义 以 及 记录 的 插入 、 删 除 和 更 新 等 SQL 语句 。 其 
中 定义 表 的 SQL 语句 分 几 步 介 绍 。 

1. 定义 表 的 基本 格式 

定义 表 的 SQL 语句 是 CREATE TABLE, 其 基本 格式 如 下 : 


CREATE TABLE [schema-name.]table-name ( 
{column- definitionltable-level-constraint} 
[, {column-definitionl|ltable-level-constraint}] * 


) 


架构 名 (schema-name) 是 可 选项 。 若 不 指定 架构 名 ,将 在 当前 缺 省 架构 中 创建 表 。 

说 明 : 

(1) 在 SQL 语法 格式 中 ,小 写字 体 表示 该 项 应 根据 需要 和 情况 具体 指定 。 

(2) 符号 [表示 该 项 为 可 选项 。 

(3) 符号 []* 表示 该 项 可 重复 0 至 多 次 。 

(4) 符号 | 可 以 将 两 项 或 多 项 连接 起 来 ,表示 选择 其 中 一 项 。 为 标明 第 一 项 的 开始 处 及 
最 后 一 项 的 结尾 处 ,可 用 符号 {} 将 这 些 选项 括 起 来 。 

2. 定义 列 

定义 一 个 表 的 主要 工作 是 定义 表 中 各 列 , 列 定义 (column-definition) 的 常用 格式 如 下 : 


column-name data- type 
[column- level-constraint]* 
[{ 
DEFAULT constant-expression| 
GENERATED {ALWAYS |BY DEFAULT} AS IDENTITY 
[ (START WITH valuel[, INCREMENT BY value2])] 
}] 


[column- level-constraint]* 
列 名 (column-name) 和 列 数据 类 型 (data-type) 是 必 选 项 。 在 Java DB 中 ,常用 的 数据 类 


型 如 表 11-1 所 示 。 其 中 ,第 1 列 *SQL 类 型 "给 出 的 是 在 定义 列 时 可 采用 的 各 种 数据 类 型 ， 
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第 3 列 *Java 类 型 "给 出 的 是 Java 程序 在 处 理 数据 表 的 各 种 类 型 数据 时 可 采用 的 最 适当 的 


数据 类 型 。 
表 11-1 Java DB 数据 库 支 持 的 数据 类 型 

SQL 类 型 说 明 Java 类 型 
SMALLINT 2 字 节 短 整 弄 java. lang. Short 
INTEGER 或 INT 4 字 节 整 型 java. lang. Integer 
BIGINT 8 字 节 长 整 型 java. lang. Long 
REAL 4 字 节 单 精度 浮 点 数 java. lang. Float 
DOUBLE 8 字 节 双 精 度 浮 点 数 java. lang. Double 
DECIMALL[L (precision[ ,scale])] 固定 精度 和 小 数位 java. math. BigDecimal 
CHAR[ (length)] 固定 长 度 字符 串 ,默认 值 长 度 为 1 java. lang. String 
VARCHAR(length) 可 变 长 度 字符 串 , 最 多 32 672 字符 java. lang. String 
DATE 日 期 java, sql, Date 
TIME 时 间 java. sql. Time 
TIMESTAMP 日 期 时 间 java. sql. Timestamp 
BLOB[ (length[K| M|GJ)] 默认 长 度 为 2G 字 节 (最 大 值 ) java. sql. Blob 
CLOBL (length[ KI| MI GJ])] 默认 长 度 为 2G 字符 (最 大 值 ) java. sql. Clob 


DEFAULT 短语 可 以 为 当前 列 指定 缺 省 值 ,下 面 是 一 些 例 子 : 


。 DEFAULT ' 男 ' 
。 DEFAULT 18 


。DEFAULT DATE('2000-1-17) 

。 DEFAULT TIMESTAMP('2000-1-1 12:0:00) 
。 DEFAULT CURRENT_TIME 

。 DEFAULT CURRENT_TIMESTAMP 
GENERATED 短语 可 以 将 当前 列 指定 为 身份 列 。 一 个 表 至 多 只 能 有 一 个 身份 列 , 身 


份 列 的 数据 类 型 只 能 是 整数 ,包括 SMALLINT INT 或 BIGINT。 


身份 列 的 值 通常 由 系统 自动 产生 , 初 值 为 valuel (默认 值 为 1), 以 后 每 次 增加 value2 
(默认 值 为 1) 。 身 份 列 不 会 自动 产生 索引 。 
在 定义 身份 列 时 , 若 指定 ALWAYS 选项 , 则 身份 列 的 值 总 是 由 系统 自动 产生 ,不 能 指 
定 , 也 不 能 更 新 。 在 插入 记录 时 ,应 缺 省 身份 列 , 或 将 其 值 指定 为 DEFAULT。 此 时 ,身份 


列 的 值 是 唯一 的 。 


在 定义 身份 列 时 , 若 指定 BY DEFAULT 选项 , 则 身份 列 的 值 既 可 以 自动 产生 ,也 可 以 
显 式 指定 。 此 时 ,身份 列 的 值 不 能 保证 是 唯一 的 。 


3. 定义 列 级 约束 


在 定义 列 时 ,可 以 指定 列 级 约束 (columnr-level-constraint) 。 列 级 约束 的 常用 格式 如 下 : 
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NOT NULLI 
[CONSTRAINT constraint-name] 
* 
CHECK (1ogic-expression) | 
PRIMARY KEY1| 
UNIQUE | 
REFERENCES [schema-name.]table-name[(column-name>)] 
[ON DELETE {NO ACTION|IRESTRICTICASCADE |SET NULL}] 
[ON UPDATE {NO ACTION|IRESTRICT }]} 


} 


NOT NULL 指明 该 列 不 能 取 空 值 。 

其 他 列 级 约束 可 以 有 选择 地 指定 一 个 约束 名 (constraint-name) ,包括 : 

(1) CHECK 约束 指明 该 列 取 值 应 满足 的 条 件 , 比 如 : CHECK (sex==' 男 ' OR sex 一 ' 女 ) 。 

(2) PRIMARY KEY 指明 该 列 是 主 关键 字 。 主 关键 字 不 能 是 空 值 ,会 自动 产生 索引 。 

(3) UNIQUE 指明 该 列 取 值 必须 唯一 。 唯 一 键 可 以 是 空 值 , 会 自动 产生 索引 。 

(4) REFERENCES 指明 该 列 是 外 键 ,并 指出 被 参照 的 表 和 列 。 由 于 被 参照 列 总 是 被 
参照 表 的 主键 列 , 所 以 被 参照 列 通常 可 以 被 省 略 。 

REFERENCES 约束 同时 可 指明 在 当前 表 中 有 相关 记录 时 是 否 可 删除 (DELETE) 被 参 
照 记录 或 更 新 (UPDATE) 被 参照 记录 的 主键 。NO ACTION 或 RESTRICT 表示 禁止 删除 
被 参照 记 录 或 更 新 其 主键 ;CASCADE 表示 在 删除 被 参照 记录 时 ,同时 删除 当前 表 中 的 相关 
记录 ;SET NULL 表示 在 删除 被 参照 记录 时 ,将 当前 表 中 的 相关 记录 的 当前 列 设置 为 空 值 。 

4. 定义 表 级 约束 

表 级 约束 (table-level-constraint) 往 往 涉 及 多 个 列 ,所 以 不 能 定义 在 单个 列 上 ,但 表 级 
约束 与 列 级 约束 涉及 的 有 关 约 束 概念 大 致 相同 。 定 义 表 级 约束 的 常用 格式 如 下 : 


[CONSTRAINT <constraint-Name>] 
{ 
CHECK (<logic-expression>)| 
PRIMARY KEY (column-name[,column-name] * )| 
UNIQUE (column-name[,column-name]*)| 
FOREIGN KEY (column-name[,column-name] *) 
REFERENCES [schema-name.]table-name[(column-name[,column-name] * )] 
[ON DELETE {NO ACTION|RESTRICTICASCADE |SET NULL}] 
[ON UPDATE {NO ACTIONIRESTRICT }] 


5. 定义 表 举 例 
这 里 以 数据 库 luntan 为 例 , 说 明 表 的 定义 。 数 据 库 luntan 将 应 用 于 论坛 应 用 项 目 , 其 
中 包含 客户 表 .主题 表 和 回复 表 ,三 个 表 都 存放 在 该 数据 库 的 loubuye 架构 中 。 
客户 表 (client) 的 具体 要 求 如 表 11-2 所 示 ,相应 的 定义 语句 如 代码 清单 11-1 所 示 。 
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表 11-2 客户 表 
列 ( 字 段 ) 名 | 类 型 说 明 


username | varchar(15) | 登录 名 , 主 关键 字 


password | varchar(15) | 口令 ,不 能 取 空 值 


gender char 性 别 , 只 能 取 " 男 "或 " 女 " ,默认 值 为 " 男 " 
email varchar(25) | 邮件 地 址 ,不 能 取 空 值 


文化 程度 ,可 取 空 值 (默认 值 ) 或 以 下 各 字符 :1: 高 中 或 高 中 以 下 2: 大 专 3: 
本 科 4: 硕 士 5: 博 士 或 博士 后 


degree char 


代码 清单 11-1 定义 client 表 


CREATE TABLE loubuye.client ( 
username varchar (15) primary key, 


password varchar (15) NOT NULL, 


email varchar (25) NOT NULL, 


BS 
& 
i 
4. gender char NOT NULL CHECK (gender= ' 男 ' OR gender=' 女 ') DEFAULT ' 男 '， 
Ss 
和 degree char CHECK (degree IN('1','2','3','4','5')) 

SE 


); 
如 果 某 列 既 没有 指定 NOT NULL, 也 没有 指定 DEFAULT 短语 , 则 其 默认 值 为 空 值 。 
主题 表 (topic) 的 具体 要 求 如 表 11-3 所 示 , 相 应 的 定义 语句 如 代码 清单 11-2 所 示 ,假设 
当前 缺 省 架构 为 loubuye。 


表 11-3 ”主题 表 

列 (字段 ) 名 类 型 说 明 
id int 主题 帖 编号 , 主 关 键 字 ,身份 列 ( 初 值 和 步 长 均 为 1) 
username varchar(15) 发 帖 人 ,不 能 取 空 值 ,外 键 
title varchar(50) 标题 ,不 能 取 空 值 
content varchar(1000) 内 容 ,不 能 取 空 值 
createtime timestamp 发 帖 时 间 ,不 能 取 空 值 , 默 认 值 为 当前 日 期 时 间 
clickcount int 点 击 数 ,不 能 取 空 值 ,默认 值 为 0 
replycount int 回复 数 ,不 能 取 空 值 ,默认 值 为 0 
lastreplyuser varchar(15) 最 后 回复 人 ,不 能 取 空 值 ,外 键 
lastreplytime timestamp 最 后 回复 时 间 ,不 能 取 空 值 ,默认 值 为 当前 日 期 时 间 


代码 清单 11-2 ”定义 topic 表 


1. CREATE TABLE topic ( 
2。 id int PRIMARY KEY GENERATED ALWAYS AS IDENTITY, 
和 username varchar (15) NOT NULL CONSTRAINT topic fkl REFERENCES client, 
4. title varchar (50) NOT NULL, 
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content varchar (1000) NOT NULL, 

createtime timestamp NOT NULL DEFAULT CURRENT TIMESTAMP, 

clickcount int NOT NULL DEFAULT 0, 

replycount int NOT NULL DEFAULT 0, 

lastreplyuser varchar (15) NOT NULL CONSTRAINT topic fk2 REFERENCES client, 
lastreplytime timestamp NOT NULL DEFAULT CURRENT TIMESTAMP 


ee 


回复 ( 跟 帖 ) 表 (reply) 的 具体 要 求 如 表 11-4 所 示 , 相 应 的 定义 语句 如 代码 清单 11-3 所 
示 ,假设 当前 缺 省 架构 为 loubuye。 


int 


表 11-4 跟 帖 表 
说 明 


| int | 同 复 帖 编号 , 主 关键 字 , 身 份 列 ( 初 信和 步 长 均 为 1) 


username 回复 人 ,不 能 取 空 值 ,外 键 
content 回复 内 容 ,不 能 取 空 值 
pep 回复 时 间 , 不 能 取 空 值 ,默认 值 为 当前 日 期 时 间 


topid int 主题 帖 编号 ,不 能 取 空 值 ,外 键 


代码 清单 11-3 定义 reply 表 


2 
| 
4. 
5 
6 
7 


6. 


. CREATE TABLE reply ( 


id int PRIMARY KEY GENERATED ALWAYS AS IDENTITY, 

username varchar (15) NOT NULL CONSTRAINT reply fk] REFERENCES client, 
content varchar (1000) NOT NULL, 

replytime timestamp NOT NULL DEFAULT CURRENT TIMESTAMP, 

topid int NOT NULL CONSTRAINT reply fk2 REFERENCES topic(id) 


0); 


修改 表 结 构 


修改 表 结 构 的 语句 是 ALTER TABLE ,其 基本 格式 如 下 : 


ALTER TABLE table- Name 


{ 


ADD {COLUMN column- definitionl|ltable-level-constraint }| 
DROP { COLUMN column-name|CONSTRAINT constraint-name}| 
ALTER COLUMN column- Name 
{ 
[NOoT ] NULL1 
SET DATA TYPE VARCHAR (integer) | 
RESTART WITH integer-constant|SET INCREMENT BY integer- constant1| 
DEFAULT default-value|lDROP DEFAULT 


或 指 


该 语句 可 以 完成 的 功能 包括 : 添加 (ADD) 新 列 或 新 的 表 级 约 东 ;删除 (DROP) 指 定 列 
定 的 约束 ;修改 已 有 列 的 定义 等 。 
对 列 的 修改 往往 会 有 诸多 限制 ,如 某 列 已 有 记录 取 值 为 空 值 ,就 不 能 再 将 其 设置 为 


NOT NULL。 列 的 数据 类 型 一 般 不 能 修改 ,但 可 以 增加 VARCHAR 类 型 的 宽度 。 


例如 ,要 为 客户 表 client 添加 一 个 状态 列 status, 列 描述 如 下 : 

。 数据 类 型 为 char(1) 。 

。 列 取 值 范 围 : 0( 不 在 线 )、1( 在 线 )。 

。 默认 值 为 0。 

可 以 使 用 以 下 语句 : 

ALTER TABLE client ADD COLUMN status char CHECK (status IN('0','1')) DEFAULT '0'» 
又 例如 ,要 设置 客户 表 client 的 状态 列 status 不 能 取 空 值 . 可 以 使 用 以 下 语句 ， 

ALTER TABLE client ALTER COLUMN status NOT NULL; 


在 执行 该 命令 时 , 表 中 所 有 记录 在 status 列 上 不 能 有 空 值 。 
7. 插入 记录 
插入 记录 的 SQL 语句 是 INSERT, 其 基本 格式 如 下 : 


INSERT INTO [schema-name.]table-name[(column-name[,column-name] * )] 
VALUES ({expression|DEFAULT}[, {expression|DEFAULT}] *) 
[, ({expression|DEFAULT}[, {expression|DEFAULT}] * ) ] * 


一 条 INSERT 语句 可 以 插入 一 条 记录 或 多 条 记录 。 表 名 (table-name) 后 括号 内 的 列 名 


表 给 出 插入 操作 所 涉及 的 列 ,各 列 的 取 值 在 VALUES 短语 中 一 一 对 应 指定 。 关 键 字 
DEFAULT 表示 对 应 列 取 缺 省 值 。 对 于 列 名 表 中 没有 给 出 的 列 , 其 值 也 取 缺 省 值 。 如 果 缺 
省 列 名 表 , 意 味 着 包含 表 中 所 有 列 。 


例如 ,下 面 语句 可 以 在 客户 表 client 中 插入 一 条 记录 : 性 别 (gender) 取 缺 省 值 * 男 ”, 文 


化 程度 (degree) 取 缺 省 空 值 ,状态 (status) 取 缺 省 值 0。 


INSERT INTO client (username, password, email) VALUES ('loubuye', '123456', 'loubuye@ 163. 


com'); 


INSERT INTO client VALUES ('loubuye', '123456', DEFAULT, ‘loubuye@ 163. com', DEFAULT, 
DEFAULT); 


例如 ,下 面 语 句 可 以 在 主题 表 topic 中 插入 一 条 记录 。 


INSERT INTO topic VALUES ( 
DEFAULT, /* 主题 帖 标识 符 自动 产生 * / 
'loubuye', 'title','content'， /xx 发 帖 人 、 标 题 和 内 容 不 能 取 空 值 ,也 没有 缺 省 值 * / 
DEFAULT, DEFAULT, DEFAULT, 'loubuye', DEFAULT); 


例如 ,下 面 语句 可 以 在 主题 表 topic 中 插入 多 条 记录 。 
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件 。 


INSERT INTO topic VALUES 
(DEFAULT, 'loubuye', 'titlel', 'content1', DEFAULT, DEFAULT, DEFAULT, "1oubuye',DEFRAULT)， 
(DEFAULT, 'loubuye', 'title2', 'content2',DEFAULT, DEFAULT, DEFAULT, 'loubuye', DEFAULT), 
(DEFAULT, 'loubuye', 'title3', 'content3',DEFAULT, DEFAULT, DEFAULT, 'loubuye', DEFAULT); 


8. 删除 记录 
删除 记录 的 SQL 语句 是 DELETE ,其 常用 格式 如 下 : 


DELETE FROM [schema-name.]table-name [WHERE boolean-expression] 

WHERE 短语 指定 删除 哪些 记录 , 即 用 逻辑 表达 式 (boolean-expression) 指定 删除 条 
如 果 缺 省 WHERE 短语 ,意味 着 删除 表 中 所 有 记录 。 

例如 ,下 面 语 句 可 以 从 主题 表 topic 中 删除 表 识 符 id 为 1 的 帖子 。 

DELETE FROM topic WHERE id=1; 


9. 更 新 记录 
更 新 记录 的 SQL 语句 是 UPDATE, 其 常用 格式 如 下 : 


UPDATE [schema-name.]table-name 
SET column-name= {expression|DEFAULT} [,column-name={expression|DEFAULT}] * 


[WHERE boolean-expression] 


SET 短语 指定 为 一 列 或 多 列 设置 新 的 值 或 缺 省 值 (在 定义 表 时 指定 的 )。WHERE 短 


语 指定 更 新 哪些 记录 。 如 果 缺 省 WHERE 短语 ,意味 着 更 新 表 中 所 有 记录 。 


例如 ,下 面 可 以 更 新 主题 表 topic 中 编号 为 2 的 主题 帖 : 
。 点 击 数 和 回帖 数 均 置 为 1。 

。 最 后 回帖 人 设 为 "loubuye”。 

。 最 后 回帖 时 间 设 为 当前 时 间 。 


UPDATE topic 
SET clickcount=1,replycount=1, 

lastreplyuser="'loubuye', lastreplytime=CURRENT TIMESTAMP 
WHERE id=2; 


11.2 JPA 概述 


Java 持久 性 应 用 程序 编程 接口 (Java Persistence API, JPA) 为 开发 人 员 提 供 了 一 种 实 


现 对 象 一 关系 映射 (Object-Relational Mapping， ORM) 的 设施 。 利 用 该 设施 ,可 以 在 应 用 
程序 中 指定 如 何 把 一 组 Java 类 、 对 象 和 实例 变量 映射 到 关系 数据 库 中 的 表 、 行 和 列 , 进 而 可 
以 通过 对 Java 对 象 的 相关 操作 来 实现 对 关系 数据 的 创建 ,访问 、 更 新 和 删除 等 操作 。 


在 JPA 中 ,相关 Java 类 称 为 实体 类 。 与 普通 的 Java 类 相 比 ,实体 类 的 定义 需要 通过 特 


定 元 数据 定义 它 与 关系 数据 库 之 间 的 映射 关系 。 大 多 数 情况 下 ,一 个 实体 类 对 应 关系 数据 
库 中 的 一 个 表 , 一 个 实体 类 的 实例 对 应 表 中 的 一 条 记录 ,一 个 持久 性 实例 变量 (属性 ) 对 应 表 
中 的 一 列 (字段 )。 

» 252。 


JPA 包含 三 个 方面 内 容 : 

(1) 对 象 一 关系 映射 元 数据 ,用 于 定义 如 何 将 实体 类 、 变 量 映射 到 数据 库 表 和 列 ; 

(2) EntityManager API, 用 于 对 实体 执行 CRUD 持久 化 操作 的 标准 API; 

(3) Java 持久 性 查询 语言 与 Query API, 支 持 实 体 查询 以 及 批量 更 新 和 删除 操作 。 

JPA 本 质 上 是 一 种 标准 或 规范 ,不同 的 厂商 可 以 有 自己 的 实现 。 实 现 该 规范 的 软件 产 
品 称 为 持久 性 提供 器 ,常见 的 如 TopLink .Hibernate EclipseLink 等 。 

说 明 : 

(1) 术语 “实体 "有 时 指 实体 类 、 有 时 指 实体 类 的 实例 或 数据 库 中 的 记录 ,阅读 时 应 根据 
上 下 文 来 理解 。 

(2) 实体 类 与 关系 数据 库 之 间 的 映射 关系 既 可 以 在 XML 文件 中 用 特定 元 素 进行 声明 ， 
也 可 以 直接 在 Java 类 中 用 特定 Java 标注 进行 声明 。 本 书 采用 后 一 种 方式 。 


11.3 实 体 类 


通常 ,一 个 实体 类 代表 关系 数据 库 中 的 一 个 表 。 实 体 类 的 定义 类 似 于 一 般 JavaBean 类 
的 定义 ,但 需要 包含 一 些 用 于 指定 映射 关系 的 Java 标注 。 

下 面 是 定义 实体 类 时 应 满足 的 基本 要 求 

。 实体 类 必须 由 Entity 型 标注 修饰 ,其 主键 实例 变量 必须 由 Id 型 标注 或 其 他 相应 的 
标注 修饰 。 

。 必须 有 一 个 public 或 protected 的 无 参 构造 方法 ,也 可 以 包含 其 他 的 构造 方法 。 

。 实体 类 不 能 是 final 的 ,持久 性 实例 变量 的 getter 和 setter 方法 也 不 能 是 final 的 。 

。 持久 性 实例 变量 不 能 声明 为 public, 客 户 应 该 通过 相关 方法 访问 实体 状态 。 

。 如 果实 体 实例 需要 按 值 传递 ,那么 实体 类 必须 实现 java. io. Serializable 接口 , 即 实 体 
实例 是 可 序列 化 的 。 


11.3.1 了 映射 表 


@Entity 标注 用 于 修饰 类 ,指定 该 类 是 一 个 实体 类 。@Table 标注 用 于 修饰 实体 类 ,可 
以 用 name 属性 指定 该 实体 类 对 应 的 数据 库 表 的 表 名 。@ Table 标注 是 可 选 的 。 如 果 省 略 
它 , 实 体 类 映射 至 与 实体 类 简单 名 同名 的 数据 库 表 。 

下 面 代码 演示 了 如 何 将 Client 类 映射 至 数据 中 的 CLIENT 表 。 


package entity; 

import java.io.Serializable; 

import javax.persistence.Entity; 

import javax.persistence.Table; 

@Entity 

@Table (name="CLIENT") 

public class Client implements Serializable { 
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因为 数据 库 系统 并 不 都 支持 混合 大 小 写 的 表 名 称 ,所 以 在 本 例 中 ,即使 省 略 @Table 标 
注 , 持 久 化 提供 器 通常 也 会 将 该 实体 类 映射 至 CLIENT 表 。 
如 无 特别 说 明 ,本 章 所 述 标注 、 接 口 等 类 型 都 定义 在 javax. persistence 包 中 。 


11.3.2 映射 列 


@Basic 标注 指明 一 种 基本 映射 , 即 其 修饰 的 持久 性 实例 变量 值 将 直接 映射 为 数据 库 中 
对 应 列 的 值 。@Basic 标注 可 修饰 以 下 类 型 的 持久 性 实例 变量 : 

。 Java 基本 类 型 .基本 类 型 包装 类 。 

。 java. lang. String。 

。 java. math. BigInteger，java. math. BigDecimal。 
java. util. Date, java. util. Calendar, java. sql. Date java. sql. Time 、java，sql. 
TimeStamp 。 
byte[], Byte[ ], char[], Character[ ]。 

。 枚 举 类 型 。 
其 他 可 序列 化 类 型 。 

对 这 些 类 型 的 实例 变量 ,即使 没有 显 式 指定 @Basic 标注 ,也 会 隐 式 指定 该 标注 , 且 其 各 
属性 取 默 认 值 。@Basic 标注 的 属性 包括 optional 和 fetch。optional 属性 指定 该 实例 变量 
是 否 可 以 取 null, 默认 值 为 true。fetch 属性 指定 实例 变量 值 是 延迟 加 载 (FetchType. 
LAZY) 还 是 预先 获取 (FetchType.EAGER) ,默认 值 是 FetchType. EAGER。 

默认 情况 下 ,实体 类 声明 的 每 个 持久 性 实例 变量 映射 至 相同 名 称 的 列 ,如 name 变量 映 
射 至 NAME 列 。 显 式 指定 @Column 标注 可 以 覆盖 映射 列 的 一 些 默认 特性 。 下 面 代码 指 
定 实例 变量 name 不 能 取 null 值 .应 映射 到 数据 库 表 的 XM 列 。 


QBasic (optional=false) 
@Column (name="XM") 


private String name; 


说 明 : 在 JPA 中 ,映射 列 可 以 采用 变量 和 属性 两 种 方式 。 采 用 变量 方式 时 ,映射 标注 
应 该 修饰 持久 性 实例 变量 ,持久 性 提供 器 将 通过 直接 访问 实例 变量 来 保持 实体 实例 的 状态 
与 数据 库 同步 。 采 用 属性 方式 时 ,映射 标注 应 该 修饰 于 持久 性 实例 变量 相应 的 getter 方法 ， 
持久 性 提供 器 将 通过 调用 getter 方法 和 setter 方法 来 保持 实体 实例 的 状态 与 数据 库 同 步 。 
为 简化 起 见 ,本 书 仅 采 用 变量 方式 。 

当 实 例 变量 的 类 型 为 java. util. Date 或 java. util. Calendar 时 ,需要 显 式 使 用 @Temporal 
标注 以 指明 其 将 映射 到 数据 库 DATE( 包 括 年 月. 日) TIME( 仅 存储 时 间 , 不 包括 年 .月 、 
日 ) 和 TIMESTAMP( 包 括 年 .月 .日 和 时 间 ) 中 的 哪 种 数据 类 型 。 下 面 代码 将 实例 变量 
ordertime 映射 至 数据 表 列 ORDERTIME, 其 中 实例 变量 的 类 型 为 java. util. Date, 数据 表 
列 的 类 型 为 SQL 类 型 TIMESTAMP。 


@Column (name="ORDERTIME") 
@Temporal (TemporalType.TIMESTAMP) 
private Date ordertime; 
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@Temporal 标注 只 有 唯一 的 value 属性 ,其 取 值 可 以 是 : 


» TemporalType.DATE 


// 映 射 为 日 期 
。 TemporalType.TIME // 映 射 为 时 间 
。 TemporalType.TIMESTAMP // 映 射 为 日 期 时 间 


11.3.3 实体 主键 


每 个 实体 类 必须 有 一 个 主键 ,每 个 实体 实例 都 有 唯一 的 主键 值 。 主键 可 以 是 单个 持久 


性 实例 变量 ,此 时 该 实例 变量 应 该 由 Id 型 标注 修饰 。 下 面 代码 指明 在 实体 类 Client 中 , 持 
久 性 实例 变量 username 是 主键 。 


public class Client implements Serializable { 
@Id 


private String username; 


主键 也 可 以 由 多 个 持久 性 实例 变量 组 合 而 成 ,此 时 可 以 定义 一 个 包含 这 些 持久 性 变量 
的 主键 类 ,而 原 实体 类 的 主键 则 可 定义 成 该 主键 类 类 型 的 一 个 实例 变量 。 如 
@Embeddable 


public class OrderitemsPK implements Serializable { 
private int id; 


private String bh; 


@Entity 


public class Orderitems implements Serializable { 
@EmbeddedId 


protected OrderitemsPK orderitemsPK; 


这 里 ,每 一 个 订单 项 由 id( 订 单 号 ) 和 bh( 图 书 编号 ) 共 同 标识 。 主 键 类 用 @Embeddable 标 
注 修饰 ,而 实体 类 中 作为 主键 的 主键 类 类 型 变量 则 用 @EmbeddedId 标注 修饰 。 

有 些 主键 值 需要 由 系统 自动 生成 ,这 类 主键 称 为 代理 键 (surrogate key)。 与 之 相对 
应 ,由 业务 数据 构成 的 主键 称 为 自然 键 natural key) 。 代 理 键 的 例子 如 订单 号 、 帖 子 编 
号 等 。 

在 JPA 中 , 枚 举 类 型 GenerationType 定义 了 代理 键 值 自动 生成 的 若干 方式 : 

。 GenerationType. IDENTITY: 基于 身份 列 生成 。 

。 GenerationType. SEQUENCE: 利用 数据 库 序列 生成 。 

。 GenerationType. TABLE: 利用 序列 表 生 成 。 

。 GenerationType. AUTO: 由 持久 性 提供 器 自主 选择 某 种 方式 生成 。 

在 实体 类 中 ,代理 键 应 该 由 @Id 标注 和 @GeneratedValue 标注 同时 修饰 。 代 更 键 什 的 
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自动 生成 方式 可 由 @GeneratedValue 标注 的 strategy 属性 指定 。 下 面 代码 定义 了 一 个 代理 
键 , 键 值 采用 身份 方式 自动 生成 。 


@Entity 

public class Topic implements Serializable { 
@Id 
QGeneratedValue (strategy=GenerationType .IDENTITY) 
private Integer id; 


这 段 代码 表示 TOPIC 表 中 的 ID 列 是 一 个 主键 , 且 是 一 个 身份 列 。 在 基于 身份 列 自动 生成 
主键 值 时 ,在 实体 数据 保存 到 数据 库 之 前 ,其 主键 值 可 能 不 可 用 ,因为 通常 在 提交 记录 时 才 
生成 它 。 

如 果 ID 列 是 一 个 主键 (代理 键 ) ,但 不 是 一 个 身份 列 ,那么 可 以 用 其 他 方式 产生 主键 值 。 
下 面 介绍 如 何 利 用 序列 表 自 动 生成 主键 值 。 

首先 应 该 定义 用 于 生成 键 值 的 序列 表 , 如 : 


CREATE TABLE sequence generator table ( 
sequence name varchar (15) PRIMARY KEY, 
sequence value int NOT NULL 

) 


其 中 ,sequence_name 列 用 于 存储 序列 的 名 称 ,sequence_value 列 用 于 存储 序列 的 当前 值 。 
接着 需要 在 上 述 表 中 插入 一 条 记录 ,指定 某 序列 的 序列 名 和 当前 值 : 


INSERT INTO sequence generator table (sequence name,sequence value) 
VALUES ('USER _ SEQUENCE"',0); 


然后 在 实体 类 中 ,用 @TableGenerator 标注 (基于 序列 表 的 主键 值 生 成 器 ) 修 饰 类 ,设置 主键 
值 生成 器 的 有 关 属 性 ;用 @GeneratedValue 型 标注 修饰 主键 变量 ,指明 用 哪个 生成 器 自动 
生成 主键 值 。 


@Entity 
@TableGenerator (name="USER GENERATOR", 
table="SEQUENCE GENERATOR TABLE", 
pkColumnName="SEQUENCE NAME", 
valueColumnName= "SEQUENCE VALUE", 
pkColumnValue="USER SEQUENCE", 
allocationSize=3) 
public class Topic implements Serializable { 
@Id 
@GeneratedValue (strategy=GenerationType .TABLE ,generator="USER GENERATOR") 
private Integer id; 


在 @TableGenerator 标注 中 ,name 属性 是 必 选 的 ,用 于 指定 生成 器 的 名 称 。 其 他 属性 
的 含义 如 下 : 

。 table: 指定 序列 表 的 表 名 。 

。 pkColumnName: 序列 表 中 存储 序列 名 称 的 列 名 。 

。 valueColumnName: 序列 表 中 存储 序列 当前 值 的 列 名 。 

。 pkColumnValue: 指定 序列 名 称 。 

。 allocationSize: 指定 序列 值 的 增 量 。 

与 基于 身份 列 生成 主键 值 不 同 ,利用 序列 表 生 成 主键 值 时 ,主键 值 在 实体 被 持久 操作 时 
就 会 产生 ,而 不 是 等 到 实体 被 实际 同步 至 数据 库 时 才 产 生 。 


11.3.4 关系 映射 


实体 之 间 的 关系 包括 一 对 一 一 对 多 和 多 对 多 ,其 中 最 常用 的 是 一 对 多 和 多 对 多 关系 。 

1. 一 对 多 关系 

假设 在 数据 库 中 包含 一 个 客户 (CLIENT) 表 和 一 个 主题 (TOPIC) 表 ,其 中 客户 和 主题 
之 间 存在 一 对 多 和 多 对 一 关系 , 即 每 个 客户 可 以 有 多 个 主题 ,而 每 个 主题 只 能 从 属于 某 个 客 
户 。 在 数据 库 设 计 中 ,为 体现 这 种 一 对 多 关系 ,往往 在 “多 ” 端 表 ( 如 主题 表 ) 中 包含 一 个 外 
键 ,存放 “一 ” 端 表 ( 如 客户 表 ) 的 主键 值 ,如 图 11-4 所 示 。 


| 一 对 多 (双向 ) | 
Client 类 | Topic 类 


CLIENT 表 TOPIC 表 
USERNAME( 主 键 ) [| ID( 主 键 ) 
PASSWORD CLIENTNAME( 外 键 ) 
GENDER TITLE 


图 11-4 一 对 多 关系 


下 面 以 此 为 例 , 介 绍 如 何在 实体 类 中 定义 实体 之 间 的 一 对 多 和 多 对 一 的 关系 。 这 里 把 
包含 外 键 的 一 端 称 为 关系 的 拥有 端 。 首 先 定义 关系 拥有 端 实体 类 , 即 Topic 类 。 
@Entity 


@Table (name="TOPIC") 


public class Topic implements Serializable{ 


@JoinColumn (name= "CLIENTNAME", referencedColumnName= "USERNAME") 
@ManyToOne 


private Client client; 


} 


实体 类 Topic 中 定义 了 一 个 关系 变量 client, 其 类 型 Client 指明 了 关系 另 一 端的 实体 
类 型 。 
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@ManyToOne 标注 指明 多 对 一 关系 , 即 多 个 Topic 型 实体 可 以 对 应 于 一 个 Client 
实体 。 

@JoinColumn 标注 指明 形成 关系 的 相关 列 , 其 中 name 属性 指定 关系 拥有 端 实 体 类 映 
射 的 数据 库 表 中 外 键 列 的 列 名 ,referencedColumnName 属性 指定 关系 非 拥 有 端 实体 类 映射 
的 数据 库 表 中 主键 的 列 名 。 

然后 定义 关系 非 拥有 端 实体 类 , 即 Client 类 。 


@Entity 


public class Client implements Serializable { 


QoneToMany (mappedBy= "client") 


private Collection<Topic>topicCollection; 


} 


实体 类 Client 中 也 定义 了 一 个 关系 变量 topicCollection, 其 类 型 是 集合 (Collection), 其 
中 泛 型 实 参 Topic 指明 了 关系 另 一 端的 实体 类 型 。 

@OneToMany 标注 指明 一 对 多 关系 , 即 一 个 Client 实体 可 以 包含 多 个 Topic 型 实体 。 
该 标注 的 mappedBy 属性 指定 关系 拥有 端 实体 类 中 相应 的 关系 变量 。 

如 上 定义 所 示 ,实体 之 间 的 一 对 多 关系 通常 被 定义 成 双向 的 ,这 使 得 查询 工作 变 得 非常 
简单 。 比 如 已 通过 JPA 查询 获得 了 一 个 主题 对 象 ,那么 主题 所 属 客户 对 象 就 会 自动 生成 并 
保存 在 关系 变量 client 中 ,调用 相应 的 getter 方 法 就 能 方便 获得 。 反 过 来 ,如 果 已 通过 JPA 
查询 获得 了 一 个 客户 对 象 ,那么 该 客户 发 表 的 所 有 主题 对 象 也 可 以 被 自动 生成 并 保存 在 关 
系 变量 topicCollection 中 ,调用 相应 的 getter 方 法 可 以 容易 地 了 解 有 关 主 题 的 信息 。 

2. 多 对 多 关系 

假设 在 数据 库 中 包含 一 个 雇员 (EMPLOYEE) 表 和 一 个 项 目 (PROJECT) 表 ,其 中 雇员 
和 项 目 存在 多 对 多 关系 , 即 每 个 雇员 可 以 参与 多 个 项 目 , 而 每 个 项 目 也 可 以 包含 多 个 雇员 。 

在 数据 库 设 计 中 ,为 体现 这 种 多 对 多 关系 ,往往 会 创建 一 个 关联 表 (E_P) ,如 图 11-5 
所 示 。 


Employee 类 | 多 对 多 (双向 ) =| Project 类 
EMPLOYEE 表 | EP 表 PROJECT 表 
ID( 主 键 ) EMP_ID( 外 键 ) | 一 ID( 主 键 ) 
NAME PRO_ID( 外 键 ) TITLE 
GENDER STATUS 


图 11-5 多 对 多 关系 


下 面 以 此 为 例 , 介 绍 如 何在 实体 类 中 定义 实体 之 间 的 多 对 多 关系 。 这 里 只 需 为 雇员 和 
项 目 分 别 定义 实体 类 Employee 和 Project, 而 无 需 为 关联 表 定 义 相 应 的 实体 类 。 另 外 可 以 
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任 选 一 个 实体 类 作为 关系 的 拥有 端 实体 类 ,这 里 假设 Employee 是 关系 的 拥有 端 实体 类 。 
@Entity 
@Table (name= "EMPLOYEE") 


public class Employee implements Serializable { 


@JoinTable (name="E Pp", 
joinCcolumns= 


{@JoinColumn (name="EMP ID",referencedColumnName="ID")}, 


inverseJoinColumns= 


{@JoinColumn (name="PRO _ ID",referencedColumnName="ID")} 
) 


@ManyToMany 


private Collection<Project>projectCollection; 


} 


实体 类 Employee 定义 了 一 个 关系 变量 projectCollection, 其 类 型 是 集合 (Collection)， 
其 中 泛 型 实 参 Project 指明 了 关系 另 一 端的 实体 类 型 。 

@ManyToMany 标注 指明 多 对 多 关系 , 即 Employee 型 实体 与 Project 型 实体 之 间 存 在 
多 对 多 关系 。 

@JoinTable 标注 指明 关联 表 及 相关 列 ,其 中 name 属性 指定 关联 表 的 名 称 ， 
joinColumns 属性 指定 关联 表 中 的 外 键 以 及 对 应 的 在 关系 拥有 端 表 中 的 主键 ， 
inverseJoinColumns 属性 指定 关联 表 中 的 外 键 以 及 对 应 的 在 关系 非 拥 有 端 表 中 的 主键 。 

然后 定义 关系 非 拥有 端 实体 类 , 即 Project 类 。 

@Entity 

@Table (name="PROJECT") 


public class Project implements Serializable { 


@ManyToMany (mappedBy="projectCollection") 


private Collection<Employee>employeeCollection; 


} 

实体 类 Project 定义 了 一 个 关系 变量 employeeCollection, 其 类 型 是 集合 (Collection)， 
其 中 泛 型 实 参 Employee 指明 了 关系 另 一 端的 实体 类 型 。 

@ManyToMany 标注 指明 多 对 多 关系 , 即 Project 型 实体 与 Employee 型 实体 之 间 存 在 
多 对 多 关系 。 标注 的 mappedBy 属性 指定 关系 拥有 端 实体 类 中 相应 的 关系 变量 。 


11.4 通过 数据 库 生 成 实体 类 
要 通过 数据 库 自 动 生 成 实体 类 ,应 该 先 创建 数据 库 连接 池 以 及 相应 的 JDBC 资源 。 下 


面 以 论坛 项 目 为 例 , 介 绍 如 何 通 过 论坛 数据 库 自动 生成 相关 实体 类 的 过 程 。 
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11.4.1 创建 数据 库 连 接 池 


Java 应 用 程序 在 访问 数据 库 之 前 需要 首先 建立 与 数据 库 的 连接 ,然后 利用 连接 对 象 完 
成 对 数据 库 的 操纵 。 

数据 库 连接 池 (DBC 连接 池 ) 是 应 用 服务 器 (如 Glassfish) 为 特定 数据 库 维 护 的 一 组 可 
重用 的 连接 。 当 应 用 程序 需要 访问 数据 库 时 ,可 以 从 连接 池 申 请 获得 一 个 连接 对 象 ,而 当 访 
问 结束 后 则 可 以 将 连接 送 回 到 连接 池 中 。 连 接 池 通过 提供 可 共享 的 数据 库 访问 连接 对 象 ， 
可 避免 应 用 程序 在 每 次 访问 数据 库 时 都 创建 一 个 新 的 物理 连接 ,从 而 缩短 访问 数据 库 的 
时 间 。 

可 以 在 JSF 应 用 创建 一 个 数据 库 连 接 池 ,其 步骤 如 下 。 

(1) 在 “项 目 ” 窗 口中 ,选择 JSF 应 用 项 目 节点 。 

(2) 从 “文件 "菜单 中 选择 “新 建文 件 " 命 令 。 

(3) 选择 文件 类 型 : Glassfish|JDBC 连接 池 。 

(4) 设置 JDBC 连接 池 的 名 称 (luntanPool) ,然后 选中 “从 现 有 连接 中 提取 ” 单 选 钮 并 从 
下 拉 列 表 中 选择 相应 的 数据 库 连 接 , 如 图 11-6 所 示 。 


全 新 建 JDBC 连接 池 


为 JDBC 庄 接 池 提供 配置 傅 息 。 
或 者 选择 现 有 的 数据 库 连 接 来 提取 信息 ， 或 者 镁 入 也 置 俏 息 . 
天 * 号 的 字 自 为 必 填 子 股 。 


nm 连 扩 志和 称 () :* [turoall 


回 人 现 有 入 挤 中 提取 四 : 
[iae:aeray://lecqhest:l5zT/laatw [Inuawrg 上 的 leah 
〇 合用 数 大 息 新 半 亿 置 中 


列表 中 记 拓 


口 雁 ( 全 局 事务 ) 


《上 一步 四 


图 11-6 创建 JDBC 连接 池 


(5) 单 击 “下 一 步 " 按 钮 ,进入 “添加 连接 池 属 性 ”选项 卡 。 一 些 基本 属性 已 经 从 前 面 选 
定 的 数据 库 连 接 中 提取 。 要 添加 新 的 属性 可 单 击 “ 添 加 ”按钮 。 

(6) 单 击 “ 下 一 步 "按钮 ,进入 “指定 连接 池 的 可 选 属性 ”选项 卡 。 这 里 ,可 以 设置 连接 池 
的 一 些 其 他 属性 ,如 : 连接 池 的 最 大 数量 .空闲 间隔 时 间 等 。 

(7) 单 击 “ 完 成 "按钮 。 

在 使 用 “新 建文 件 ” 向 导 创 建 项 目的 JDBC 连接 池 后 ,连接 池 的 名 称 和 相关 属性 会 被 保 
存在 sun-resources. xml 文件 中 ,该 文件 出 现在 项 目的 “服务 器 资源 ”节点 下 。 可 以 在 源 代码 
编辑 器 中 编辑 sun-resources. xml 以 修改 相关 属性 。 


11.4.2 创建 JDBC 资源 


通常 ,Java 应 用 程序 并 不 能 直接 向 JDBC 连接 池 中 申请 连接 对 象 ,而 是 通过 JDBC 资源 
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来 获得 连接 对 象 。 

JDBC 资源 又 称 数 据 源 ,是 对 JDBC 连接 池 的 一 个 包装 。 每 个 JDBC 资源 都 有 一 个 
JNDI 名 称 。Java 应 用 通过 该 名 称 获得 JDBC 资源 ,进而 获得 连接 对 象 并 访问 数据 库 。 

可 以 在 JSF 应 用 创建 一 个 JDBC 资源 ,其 步骤 如 下 。 

(1) 在 "项目 ” 窗 口中 ,选择 JSF 应 用 项 目 节点 。 

(2) 从 “文件 ”菜单 中 选择 “新 建文 件 ” 命 令 。 

(3) 选择 文件 类 型 : GlassFish|JDBC 资源 。 

(4) 在 "常规 属性 ?选项 卡 中 ,选择 现 有 连接 池 ,或 创建 一 个 新 的 连接 池 。 需 要 时 修改 该 
资源 的 JNDI 名 称 。 这 里 ,选择 现 有 的 连接 池 luntanPool, 并 指定 JNDI 名 称 为 jdbc/luntan， 
如 图 11-7 所 示 。 


辣 条 建 JDBC 资源 


或 者 选择 现 有 JDEC 连接 地， 孙 者 包 建 新 的 JDBC 连接 过 。 
带 * 号 的 字 股 为 必 填 字段 。 


旬 合用 现 有 JIBC 连接 池 QD 
FE 司 


口外 娃 犁 的 JIEC 连接 地 四) 


DPI 名 称 :。 Dae/ 
对 划 关 型 D) :| 
局 用 四: [i 
搓 坟 ): [ 


《上 -上 四 |] TFS> |[ Ro 


图 11-7 创建 JDBC 资源 


(5) 单 击 “ 下 一 步 ” 按 钮 ,进入 “附加 属性 ”选项 卡 。 需 要 时 可 以 添加 该 资源 的 附加 属性 。 

(6) 单 击 “ 完 成 ”按钮 。 

创建 项 目的 JDBC 资源 后 ,该 资源 的 JNDI 名 称 和 相关 属性 也 被 保存 在 项 目的 “服务 器 
资源 ”节点 下 的 sun-resources. xml 文件 中 。 

当 部 署 JSF 应 用 项 目 , 定 义 在 项 目 中 JDBC 连接 池 和 JDBC 资源 将 自动 在 应 用 服务 器 
中 进行 配置 和 注册 。 这 些 资源 既 可 以 被 当前 应 用 项 目 使 用 .也 能 被 其 他 的 应 用 项 目 使 用 。 


11.4.3 生成 实体 类 


有 了 JDBC 资源 ,就 可 以 利用 工具 通过 数据 库 自动 生成 实体 类 了 ,步骤 如 下 。 
(1) 在 “项 目 ” 窗 口中 ,选择 JSF 应 用 项 目 节点 。 
(2) 从 “文件 "菜单 中 选择 “新 建文 件 "命令 。 
(3) 选择 文件 类 型 : 持久 性 | 通过 数据 库 生 成 实体 类 。 
(4) 指定 数据 源 , 即 JDBC 资源 。 然 后 从 左边 的 “可 用 表 ” 中 选择 需要 生成 实体 类 的 相 
关 表 , IDE 将 自动 为 右边 列表 中 列 出 的 每 个 表 生 成 实体 类 。 这 里 ,选择 数据 源 为 jdbc/ 
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luntan, 并 单 击 “ 全 部 添加 ”按钮 选择 所 有 表 , 如 图 11-8 所 示 。 


童 新 建 通过 教 据 库 生成 实体 类 


ET 


全 部 添加 QU) 


《全 部 删除 如 


图 11-8 指定 要 生成 实体 类 的 数据 库 表 


(5) 单 击 " 下 一 步 ? 按 钮 ,进入 "实体 类 ?选项 卡 ,确认 实体 类 的 名 称 ` 位 置 。 实 体 类 通常 
存放 在 单独 的 Java 包 中 ,如 事先 还 没有 创建 相应 的 Java 包 , 可 以 在 此 直接 指定 包 名 ,IDE 将 
自动 创建 之 。 这 里 ,指定 entity 包 用 于 存放 生成 的 实体 类 ,如 图 11-9 所 示 。 

鱼 新 建 通过 救 据 库 生 成 实体 类 


步骤 
1， 选择 文件 类 型 
2 数据 库 束 


回 为 和 持久 性 字段 生成 已 合 名 的 查询 标注 G) 
创 吾 持久 性 单元 0D) 


图 11-9 指定 存放 实体 类 的 Java 包 


默认 情况 下 ,IDE 会 为 实体 类 自动 生成 针对 持久 性 变量 的 一 些 命名 查询 标注 ,另外 也 会 
自动 创建 相应 的 持久 性 单元 。 有 关 命 名 查询 和 持久 性 单元 的 详细 内 容 将 在 第 12 章 介 绍 。 

(6) 单 击 “ 下 一 步 ” 按 钮 ,进入 “映射 选项 ”选项 卡 ,可 以 根据 需要 指定 从 实体 类 到 表 的 一 
些 映 射 选项 。 

(7) 单 击 “ 完 成 ”按钮 。 


11.5 论坛 一 创建 数据 库 


本 节 继 续 第 6. 5 节 介 绍 的 应 用 项 目 (luntan_pagination) ,为 论坛 应 用 创建 所 需 的 Java 
DB 数据 库 ,并 产生 相应 的 实体 类 。 
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本 章 前 面 已 介绍 了 Java DB 的 基本 操作 、SQL 语句 、 实 体 类 以 及 通过 数据 库 自动 生成 
实体 类 等 内 容 , 而 所 举例 子 也 是 以 论坛 数据 库 为 主 ,所 以 本 节 主 要 是 对 前 面 内 容 进行 一 个 总 
结 , 列 出 创建 论坛 数据 库 和 产生 相应 实体 类 的 总 体 步 又 。 

为 保持 之 前 项 目的 独立 性 ,这 里 新 创建 一 个 名 为 luntan_final 的 JSF 应 用 项 目 , 并 从 原 
先 项 目 复 制 所 有 的 样式 表 文件 .JSF 页 面 、 源 包 中 的 所 有 Java 包 和 Java 类 。 


11.5.1 创建 论坛 数据 库 


在 “服务 ”窗口 , 按 以 下 步骤 创建 论坛 数据 库 。 

(1) 根据 实际 情况 设置 存放 数据 库 的 位 置 。 

(2) 创建 论坛 数据 库 , 指 定数 据 库 名 称 、 用 户 名 和 口令 。 为 后 面 叙述 方便 ,假设 数据 库 
名 为 luntan, 用 户 名 为 loubuye。 

(3) 数据 库 创建 后 ,在 “数据 库 ” 节 点 下 会 自动 产生 一 个 连接 节点 。 该 连接 节点 的 缺 省 
架构 名 字 为 创建 数据 库 时 指定 的 用 户 名 。 如 果 数 据 库 中 不 存在 该 架构 , 则 应 在 SQL 命令 窗 
口中 用 命令 “CREATE SCHEMA loubuye” 创 建 之 。 

要 查看 数据 库 中 是 否 存 在 某 架 构 , 可 右 击 数据 库 连接 节点 ,然后 选择 “连接 ”命令 ,建立 
与 数据 库 的 实际 连接 。 此 时 ,连接 节点 下 会 显示 出 数据 库 中 的 所 有 架构 。 

要 打开 SQL 命令 窗口 ,可 右 击 数据 库 连接 节点 ,然后 选择 “执行 命令 "命令 。 执 行 完 
SQL 语句 后 ,可 右 击 连接 节点 ,然后 选择 “刷新 ”命令 ,以 查看 执行 效果 。 

(4) 在 SQL 命令 窗口 ,用 代码 清单 11-1 所 示 SQL 语句 创建 客户 数据 库 表 (client) 。 

(5) 为 客户 表 client 添加 一 个 状态 列 status, 列 描述 如 下 : 

。 数据 类 型 为 char(1) 。 

。 列 取 值 范围 : 0( 不 在 线 )、1( 在 线 )。 

。 默认 值 为 0。 

。 不 能 取 空 值 。 

(6) 在 SQL 命令 窗口 ,用 代码 清单 11-2 所 示 SQL 语句 创建 主题 数据 库 表 (topic) 。 

(7) 在 SQL 命令 窗口 ,用 代码 清单 11-3 所 示 SQL 语句 创建 回复 数据 库 表 (reply) 。 

(8) 在 SQL 命令 窗口 ,用 INSERT INTO 语句 往 客 户 表 中 添加 几 条 记录 ,再 往 主题 表 
中 添加 几 条 记录 。 


11.5.2 为 论坛 应 用 创建 实体 类 


在 项目" 窗口 ,通过 数据 库 为 论坛 应 用 自动 生成 实体 类 ,具体 步骤 如 下 。 

(1) 在 论坛 应 用 luntan_final 中 ,基于 现 有 连接 ,为 论坛 数据 库 luntan 创建 JDBC 连接 
池 ,假设 连接 池 的 名 称 指定 为 luntanPool。 

创建 JDBC 连接 池 后 ,其 名 称 和 相关 属性 被 保存 在 sun-resources. xml 文件 中 ,该 文件 
放置 在 项 目的 “服务 器 资源 ”节点 下 。 

(2) 在 论坛 应 用 luntan_final 中 ,基于 以 上 建立 的 JDBC 连接 池 ,创建 JDBC 资源 ,假设 
该 资源 的 JNDI 名 称 指定 为 jdbc/luntan 。 

与 JDBC 连接 池 一 样 ,创建 JDBC 资源 后 ,该 资源 的 JNDI 名 称 和 相关 属性 也 被 保存 在 

“263 » 


sun-resources. xml 文件 中 。 

(3) 在 论坛 应 用 luntan_final 中 ,基于 以 上 的 JDBC 资源 (数据 源 ) ,为 论坛 数据 库 的 所 
有 数据 库 表 生成 相应 的 实体 类 。 保 存 实 体 类 的 位 置 选择 源 包 中 的 entity 包 , 这 样 生成 的 实 
体 类 将 覆盖 entity 包 中 原先 的 Client 类 、Topic 类 和 Reply 类 。 

代码 清单 11-4 是 通过 数据 库 自动 生成 的 Client 实体 类 的 部 分 代码 ,其 中 省 略 了 那些 不 
含 映 射 标注 的 方法 代码 。 

代码 清单 11-4 Client 实体 类 (部 分 ) 


. Package entity; 
。 import java.io.Serializable; 
. import java.util.Collection; 


. import javax.persistence.Basic; 


1 
2 
3 
4 
5. import javax.persistence.CascadeType; 
6. import javax.persistence.Column; 
7. import javax.persistence.Entity; 
8. import javax.persistence.Id; 

9. import javax.persistence.NamedQueries; 
10. import javax.persistence.NamedQuery; 
11. import javax.persistence.OneToMany; 


12. import javax.persistence.Table; 


14. @Entity 

15. @Table (name="CLIENT") 

16. @NamedQueries ({ 

了， @NamedQuery (name= "Client.findAll", query="SELECT c FROM Client c"), 
80s @NamedQuery (name= "Client.findByUsername", 

Eb query="SELECT c FROM Client c WHERE c.username= :username"), 
20 . @NamedQuery (name= "Client.findByPassword", 

21s query="SELECT c FROM Client c WHERE c.password= :password"), 
2 QNamedouery (name= "Client.findByGender", 

23， query="SELECT c FROM Client c WHERE c.gender= :gender"), 
24. @NamedQuery (name= "Client.findByEmail", 

25;, query="SELECT c FROM Client c WHERE c.email= :email"), 
26. @NamedQuery (name= "Client.findByDegree", 

Fp query="SELECT c FROM Client c WHERE c.degree= :degree"), 
28. @NamedQuery (name= "Client.findBysStatus", 

FP query="SELECT c FROM Client c WHERE c.status=:status")}) 
30. public class Client implements Serializable { 

31. private static final long serialVersionUID=1L; 

32. @Id 

33. Basic(optional=false) 

34. column (name="USERNAME") 


35. private String username; 


36。 QBasic (optional=false) 

37. ecolumn (name="PASSWORD") 

38. private String password; 

39;, @Basic (optional=false) 

40. @Column (name="GENDER") 

41. private char gender; 

42. @Basic (optional=false) 

43. column (name="EMAIL") 

44. private String email; 

45. column (name="DEGREE") 

46. Private Character degree; 

47. Basic(optional=false) 

48. ecolumn (name="STRTUS") 

49. Private char status; 

50. oneToMany (cascade=CascadeType.ALL,mappedBy= "client" 
51. private Collection<Reply>replyCollection; 

52. oneToMany (cascade=CascadeType.ALL,mappedBy= "client") 
53. private Collection<Topic>topicCollection; 


54. QoneToMany (cascade=CascadeType .ALL,mappedBy= "client1") 


55. private Collection<Topic>topicCollectionl; 
56。 

57. public Client(){ 

58 .。 } 

Ss public Client (String username){ 

60. this.username=username; 

61. } 

62. public Client (String username, String password, char gender, String email,char status){ 
63. this.username=username; 

64. this.password=password; 

655 this.gender=gender; 

66 . this.email=email; 

67. this.status=status; 

68. +t 

69. 

70,.} 


与 原先 的 Topic 类 和 Reply 类 相 比 ,新 生成 的 Topic 实体 类 和 Reply 实体 类 并 没有 实 
现 Comparable 接口 .提供 compareTo 方法 ,也 就 是 说 ,两 个 Topic 对 象 或 两 个 Reply 对 象 
是 不 能 进行 相互 比较 的 。 这 样 .就 不 能 用 Collections 类 的 sort 方法 对 一 个 List<Topic 二 
表 中 的 元 素 或 一 个 List 和 Reply 之 中 的 元 素 进 行 排序 。 因 此 , 当 按 上 述 步骤 生成 实体 类 
后 ,项 目 中 会 出 现 两 个 错误 。 一 个 是 model. TopicManager 类 的 getTopics() 方 法 中 的 
语句 : 


Collections.sort (topics); 
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另 一 个 是 model. ReplyManager 类 的 getReply(int) 方 法 中 的 语句 : 
Collections.sort (list); 


只 要 将 上 面 两 条 语句 删除 ,应 用 项 目 就 能 够 正常 运行 了 。 当 然 , 此 时 不 能 保证 页 面 上 主 
题 表 中 各 主题 以 及 回复 表 中 各 回复 是 按 一 定 的 时 间 顺 序 排序 的 。 

另外 ,虽然 在 应 用 中 已 创建 了 实体 类 ,但 model. TopicManager、model. ReplyManager 
等 类 中 的 业务 方法 访问 的 仍然 是 定义 在 model. DataBase 类 中 的 数据 。 

但 这 些 都 不 是 问题 ,在 第 12 章 ,我 们 将 重 写 这 些 业 务 方法 ,让 应 用 真正 从 已 经 创建 的 
luntan 数据 库 中 访问 数据 。 到 那 时 ,获取 按 一 定 的 顺序 排序 的 主题 记录 或 回复 记录 也 就 变 
成 一 件 轻而易举 的 事情 了 。 


11.6 小 结 


Java DB 是 一 个 纯 Java 实现 .开源 的 数据 库 管 理 系统 ,是 Java SE 6 平台 的 组 成 部 

分 , NetBeans IDE 及 Glassfish 同样 提供 了 对 Java DB 的 支持 。 

一 个 Java DB 数据 库 包 含 若 干 架构 ,每 个 架构 下 包含 若干 数据 库 表 。 数 据 库 连 接 节 

点 在 创建 时 指定 一 个 缺 省 架构 。 

Java 持久 性 应 用 程序 编程 接口 (Java Persistence API, JPA) 包 含 三 个 方面 内 容 ， 

对 象 -关系 映射 元 数据 ; 

EntityManager API; 

Java 持久 性 查询 语言 与 Query API。 

。 实体 类 的 定义 类 似 于 一 般 JavaBean 类 的 定义 ,但 还 需要 有 特别 的 映射 定义 , 即 要 定 

义 实体 类 一 数据 库 表 实例 变量 一 字段 等 的 映射 关系 。 

JDBC 连接 池 是 应 用 服务 器 为 特定 数据 库 维护 的 一 组 可 重用 的 连接 ,能 为 各 应 用 共 

享 ,可 为 各 应 用 缩短 连接 数据 库 所 需 的 时 间 。 

。 JDBC 资源 又 称 数 据 源 ,是 对 JDBC 连接 池 的 一 个 包装 ,为 本 地 或 远程 的 各 种 应 用 提 
供 了 一 个 连接 和 访问 数据 库 的 统一 的 JNDI 名 称 。 

。 在 NetBeans IDE 中 ,可 以 通过 已 有 的 数据 库 自动 生成 相应 的 实体 类 。 


习 题 11 


1. 用 于 连接 Java DB 数据 库 的 驱动 程序 有 哪 几 种 ?在 Web 应 用 中 ,一 般 应 该 选择 哪 
种 驱动 程序 ? 

2. 在 NetBeans IDE 中 , 当 创 建 一 个 Java DB 数据 库 时 ,会 自动 产生 一 个 连接 节点 。 在 
该 连接 节点 中 ,数据 库 的 缺 省 架构 的 名 称 是 什么 ? 

3. 与 普通 的 Java 类 或 JavaBean 类 相 比 ,实体 类 有 什么 特点 ? 

4. 创建 一 个 Java DB 数据 库 : 数据 库 名 称 为 bookstore、 用 户 名 为 sample、 密 码 为 
123456 ,然后 再 完成 : 
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(1) 在 该 数据 库 的 sample 架构 下 创建 数据 库 表 CLIENT, 具 体 要求 如 表 11-5 所 示 。 


表 11-5 bookstore 数据 库 的 CLIENT 表 


列 (字段 ) 名 | 类 型 与 宽度 说 列 ( 字 段 ) 名 


username 


varchar(10) | 用 户 名 , 非 空 .关键 字 phone varchar(15) | 


password 


vant io) | 口令 , 非 空 i ee | 非 空 


realname varchar(4) | 真实 姓名 , 非 空 address varchar(30) | 


性 别 , 非 空 


sex char(1) 


(2) 在 该 数据 库 的 sample 架构 下 创建 数据 库 表 BOOK ,具体 要 求 如 表 11-6 所 示 。 


表 11-6 ”bookstore 数据 库 的 BOOK 表 


列 ( 字 段 ) 名 | 类 型 与 宽 说 明 


列 ( 字 段 ) 名 | 类 型 与 宽 说 明 
bookid char(6) 编号 , 非 空 .关键 字 banci varchar(12) 版 次 


title varchar(20) 书 名 , 非 空 varchar(14) 印 次 
author varchar(4) 作者 , 非 空 varchar(15) 开本 
publisher | varchar(10) 出 版 社 , 非 空 varchar(6) 页 数 


price numeric(6,2) | 定价 , 非 空 varchar(6) 字数 
isbn varchar(15) ”| ISBN 号 , 非 空 varchar(4) 装 由 
(3) 利用 SQL INSERT 语句 在 CLIENT 表 中 添加 2 至 3 条 记录 ,在 BOOK 表 中 添加 


10 条 以 上 记录 。 
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第 12 章 实体 管理 器 与 JPQL 


本 章 主题 : 

。 持久 性 单元 

。 实体 管理 器 与 持久 性 上 下 文 
。 实体 状态 与 CRUD 操作 

。 JPQL 语言 

。 查询 API 


每 个 实体 管理 器 都 与 一 个 持久 性 上 下 文 相 关联 ,持久 性 上 下 文 管理 着 一 组 实体 实例 ,并 
在 适当 时 机 使 其 与 底层 数据 库 同步 。 持 久 性 上 下 文 能 够 管理 的 实体 实例 的 类 型 由 持久 性 单 
元 定义 。 利 用 实体 管理 器 可 以 创建 更 新 、 删 除 实体 实例 ,或 根据 主键 检索 实体 实例 ,进而 实 
现 对 数据 库 数 据 的 相应 操作 。 

JPQL(Java Persistence Query Language, Java 持久 性 查询 语言 ) 可 以 实现 对 实体 实例 
的 批量 查询 .更 新 和 删除 。JPQL 在 语法 上 与 SQL 相似 ,但 并 不 能 在 数据 库 系统 上 直接 执 
行 。 要 执行 JPQL 语句 ,需要 先 创 建 包装 有 JPQL 语句 的 查询 (Query) 对 象 ,然后 通过 调用 
该 查询 对 象 的 相关 方法 执行 其 中 的 JPQL 语句 。 


12.1 持久 性 单元 


要 在 应 用 程序 中 通过 操作 实体 实现 数据 库 访问 ,首先 需要 定义 持久 性 单元 。 一 个 持久 
性 单元 通常 需要 定义 下 面 一 些 属性 : 

。 一 组 实体 类 。 

。 一 个 数据 源 。 

。 映射 元 数据 (Java 标注 或 XML 文件 )。 

。 持久 性 提供 器 (实体 管理 器 工厂 和 实体 管理 器 ) 。 

可 见 ,一 个 持久 性 单元 定义 了 持久 性 操作 的 对 象 范围 , 即 需要 管理 哪些 实体 ,包括 实体 
类 ,数据 源 以 及 两 者 之 间 的 映射 。 另 外 ,持久 性 单元 也 定义 了 进行 持久 性 操作 的 工具 , 即 持 
久 性 提供 器 ,其 中 包括 实体 管理 器 工厂 和 实体 管理 器 。 

持久 性 单元 由 persistence. xml 文件 定义 ,包含 持久 性 单元 的 相关 属性 。persistence. 
xml 文件 中 可 以 定义 多 个 持久 性 单元 ,但 每 个 持久 性 单元 必须 有 唯一 的 名 称 。persistence. 
xml 文件 应 该 存放 在 META-INF 目录 下 ,而 存放 META-INF 目录 的 父 目录 被 称 为 持久 性 
单元 的 根 目录 。 对 于 Web 应 用 来 说 , 持久 性 单元 的 根 目录 通常 是 WEB-INF/classes。 在 
“项 目 ” 窗 口 ,persistence. xml 文件 位 于 “配置 文件 ”节点 下 。 

下 面 以 论坛 项 目 为 例 ,介绍 定义 持久 性 单元 的 步骤 。 

(1) 在 “项 目 ” 窗 口中 ,选择 JSF 应 用 项 目 节点 。 

(2) 从 “文件 ”菜单 中 选择 “新 建文 件 " 命 令 。 
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(3) 选择 文件 类 型 : 持久 性 | 持久 性 单元 。 

(4) 单 击 “下 一 步 ? 按 钮 ,进入 "提供 器 和 数据 库 ? 选 项 卡 ,指定 持久 性 单元 的 相关 属性 ， 
包括 持久 性 提供 器 和 数据 源 。 持 久 性 提供 器 提供 实体 管理 和 持久 性 操作 的 功能 ,数据 源 指 
定 与 特定 数据 库 的 连接 信息 。 

在 这 里 , 把 持久 性 单元 名 称 设 置 为 “luntanPU”, 持 久 性 提供 器 选择 为 缺 省 的 
“EclipseLink(JPA 2.0)”, 数 据 源 指定 为 “jdbc/luntan”。 另 外 取消 “使 用 Java 事务 API” 复 
选 框 ,意味 着 选用 本 地 资源 事务 。 将 表 生 成 策略 指定 为 “无 ”, 表 明 数 据 库 表 不 由 实体 类 的 生 
成 而 生成 .删除 而 删除 ,如 图 12-1 所 示 。 


鱼 新建 持久 性 单元 
提供 器 和 数据 库 
持久 性 单元 名 称 ; |luntanPUV 
为 实体 类 指定 持久 性 提供 器 和 数据 库 . 
持久 性 提供 器 :|zclipseLink OPA 2 0) 峡 省 ) 
数据 源 : Ljdbe/luntan 
口 合用 Javs 事务 AI 


表 生 成 策略 : 〇 创建 〇 易 除 并 建 中 而 


图 12-1 指定 提供 器 和 数据 源 


(5) 单 击 “ 完 成 "按钮 。 

其 中 ,“jdbc/luntan” 是 在 11. 5. 2 小 节 中 创建 的 JDBC 资源 的 JNDI 名 称 。 利 用 该 资源 
可 以 实现 与 论坛 数据 库 的 连接 。 

如 果 是 第 一 次 定义 持久 性 单元 ,工具 将 在 相应 位 置 自动 创建 persistence. xml 文件 , 持 
久 性 单元 的 相关 属性 将 保存 在 该 文件 。 如 果 是 再 次 定义 持久 性 单元 ,新 的 持久 性 单元 的 相 
关 属 性 同样 保存 在 该 文件 中 。 代 码 清单 12-1 是 persistence. xml 文件 的 一 个 例子 。 

代码 清单 12-1 persistence. xml 文件 示例 


1. <?xml version="1.0" encoding="UTF-8"?> 

2. <persistence version="2.0" xmlns="http://java.sun.com/xml/ns/persistence" 

k 调 xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/persistence 


http://java.sun.com/xml/ns/persistence/persistence 2 0.xsd"> 


4 
5 
6. <persistence-unit name="luntanPU" transaction-type="RESOURCE LOCAL"> 
7 <non-jta-data- source>jdbc/luntan</non-jta-data- source> 
8 <exclude-unlisted-classes>false</exclude-unlisted-classes> 
9 <properties/> 
10. </persistence-unit> 


11. </persistence> 
这 个 persistence. xml 文件 仅 定义 了 一 个 持久 性 单元 luntanPU .其 中 non-jta-data- 


source 元 素 指定 了 数据 源 :exclude-unlisted-classes 元 素 指 定 了 实体 类 , 即 该 持久 性 单元 包 
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含 项 目 中 所 有 的 实体 类 。 另 外 ,由 于 选择 的 持久 性 提供 器 是 缺 省 的 EclipseLink(JPA 2.0)， 
所 以 在 该 持久 性 单元 的 定义 中 并 没有 用 provider 元 素 明确 指定 。 

实际 上 ,在 “通过 数据 库 生 成 实体 类 ”时 ,如 果 项 目 中 还 没有 定义 任何 持久 性 单元 ,IDE 
会 自动 创建 一 个 持久 性 单元 ,只 是 自动 创建 的 持久 性 单元 与 上 述 有 所 不 同 , 比 如 没有 指定 实 
体 类 。 此 时 ,可 以 在 原先 定义 的 基础 上 , 按 上 述 要 求 进行 修改 ,或 者 干脆 删除 原先 的 持久 性 
单元 定义 或 文件 ,再 按 上 述 步 又 重新 创建 。 


12.2 管理 实体 


本 节 首 先 介绍 实体 管理 器 和 持久 性 上 下 文 的 概念 .实体 管理 器 API 的 基本 情况 ,然后 
详细 介绍 操作 实体 实例 的 各 种 方法 。 


11.2.1 实体 管理 器 与 持久 性 上 下 文 

实体 由 实体 管理 器 (EntityManager 对 象 ) 管 理 。 每 个 实体 管理 器 与 一 个 持久 化 上 下 文 
相关 联 。 持 久 化 上 下 文 是 一 组 受 管理 实体 实例 的 集合 。 实 体 管 理 器 借助 持久 化 上 下 文 实 
现 对 实体 的 管理 。 持 久 化 上 下 文保 证 受 管理 实体 实例 与 底层 数据 库 的 同步 ,如 图 12-2 
所 示 。 


客户 实体 管理 器 


图 12-2 实体 管理 器 与 持久 性 上 下 文 


要 创建 一 个 实体 管理 器 ,可 以 先 获得 一 个 实体 管理 器 工厂 对 象 。 调 用 Persistence 类 的 
createEntityManagerFactory 静态 方法 可 以 获得 一 个 实体 管理 器 工厂 ,其 中 应 指定 持久 性 单 
元 的 名 称 。 有 了 实体 管理 器 工厂 ,再 调用 其 createEntityManager 方法 就 可 创建 一 个 应 用 程 
序 管理 的 实体 管理 器 。 


EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanpU"); 


EntityManager em=emf .createEntityManager () 7 


调用 实体 管理 器 的 相关 方法 可 以 完成 对 实体 的 创建 、 读 取 、 更 新 和 删除 (Create、Read、 
Update、Delete,CRUD) 等 操作 。 表 12-1 列 出 实体 管理 器 的 一 些 主要 方法 。 
close 方法 用 于 关闭 实体 管理 器 并 释放 相关 资源 。 一 旦 执行 了 该 方法 ,就 不 应 再 试图 调 
用 该 实体 管理 器 的 方法 进行 相关 的 实体 操作 ,或 通过 由 该 实体 管理 器 创建 的 查询 对 象 执行 
查询 操作 。 
每 个 实体 管理 器 都 会 与 一 个 持久 性 上 下 文 相关 联 。 与 应 用 程序 管理 的 实体 管理 器 相关 
联 的 持久 性 上 下 文 会 随 着 实体 管理 器 的 创建 而 自动 生成 ,通常 也 会 随 着 实体 管理 器 的 关闭 
"0 


而 自动 释放 。 
表 12-1 EntityManager 接口 中 的 常用 方法 

描 述 
使 指定 实体 实例 持久 性 并 受 管理 
合并 指定 实体 实例 状态 至 持久 性 上 下 文 
删除 指定 的 实体 实例 
根据 主键 值 查找 实体 实例 
用 持久 性 上 下 文中 的 实体 实例 状态 刷新 底层 数据 库 
用 底层 数据 库 重 置 指定 实体 实例 的 状态 
根据 JPQL 语句 创建 查询 对 象 


方 ”法 


void persist(Object entity) 


=<T> T merge(T entity) 


void remove(Object entity) 


一 T>T find(Class<T> entityClass, Object key) 


void flush() 


void refresh(Object entity) 


Query createQuery(String jpqlString) 


Query createNamedQuery(String name) 创建 查询 对 象 以 执行 命名 查询 
void close() 关闭 应 用 程序 管理 实体 管理 器 
void clear() 使 所 有 受 管理 实体 实例 成 为 分 离 的 
EntityTransaction getTransaction() 获得 资源 本 地 类 型 的 事务 对 象 


12.2.2 实体 操作 


这 里 介绍 若干 常用 的 用 于 操作 实体 实例 的 EntityManager 方法 。 通 过 这 些 方法 ,我们 
可 以 进行 对 实体 实例 的 CRUD 操作 ,进而 完成 对 关系 数据 的 创建 、 读 取 、 更 新 和 删除 操作 。 

1. 实体 的 状态 

EntityManager 方法 可 能 会 改变 实体 实例 的 状态 。 实 体 实例 的 状态 包括 四 种 : 新 的 、 受 
管理 的 、 分 离 的 和 删除 的 。 

(1) 新 的 实体 实例 : 没有 持久 性 身份 .还 没有 与 持久 性 上 下 文 相关 联 。 

(2) 受 管理 的 实体 实例 : 有 持久 性 身份 .与 持久 性 上 下 文 相关 联 。 

(3) 分离 的 实体 实例 : 有 持久 性 身份 .当前 没有 与 持久 性 上 下 文 相关 联 。 

(4) 删除 的 实体 实例 : 有 持久 性 身份 .与 持久 性 上 下 文 相关 联 , 但 其 映射 的 持久 化 存储 
数据 将 被 删除 。 

图 12-3 总 结 了 实体 实例 的 状态 转换 。 

与 持久 性 上 下 文 相关 联 的 实体 实例 包括 受 管理 和 删除 的 实体 实例 。 对 这 些 实体 实例 ， 
持久 性 提供 器 会 在 适当 的 时 机 保证 它们 与 数据 库 同步 ,比如 用 受 管理 实体 实例 的 状态 更 新 
数据 库 中 相应 记录 的 数据 ,从 数据 库 中 删除 与 删除 的 实体 实例 相对 应 的 记录 。 利 用 实体 管 
理 器 的 remove 方 法 可 以 将 受 管理 的 实体 实例 转换 成 删除 的 实体 实例 。 

新 的 实体 实例 没有 持久 性 身份 ,意味 着 它 在 数据 库 中 还 没有 相应 的 记录 。 利 用 实体 管 
理 器 的 persist 方 法 可 以 将 新 的 实体 实例 转换 成 受 管理 的 实体 实例 。 这 样 ,持久 性 提供 器 在 
确保 实体 数据 与 数据 库 同步 时 ,就 会 在 数据 库 中 插入 相应 的 记录 。 

分 离 的 实体 实例 有 持久 性 身份 ,意味 着 它 在 数据 库 中 有 相应 的 记录 。 分 离 的 实体 实例 
没有 与 持久 性 上 下 文 相关 联 , 所 有 分 离 的 实体 实例 状态 的 改变 并 不 能 同步 至 数据 库 。 利 用 

二 全 证 入 


remove 方法 


find 方法 /查询 


图 12-3 实体 状态 转换 图 


实体 管理 器 的 merge 方法 可 以 将 分 离 的 实体 实例 转换 成 受 管理 的 实体 实例 。 

2. 查找 实体 实例 

查找 实体 实例 的 最 简单 方法 是 使 用 EntityManager 的 find 方法 。 其 他 方法 涉及 JPQL 
和 查询 API, 这 些 内 容 将 在 12. 4 节 详 细 介 绍 。 

EntityManager 的 find 方法 能 够 根据 主键 值 查找 相应 的 实体 实例 ,其 格式 如 下 : 


public <T>T find (Class<T>entityClass,Object primaryKey) 


使 用 说 明 : 

(1) 第 一 个 参数 的 类 型 必须 是 实体 类 型 ;第 二 个 参数 的 类 型 必须 是 实体 的 主键 类 型 。 

(2) 若 方法 找到 相应 的 实体 实例 ,就 返回 该 实体 实例 , 且 该 实体 实例 处 于 受 管 理 状态 ; 
否则 返回 null。 

(3) 若 第 一 个 参数 不 是 一 个 实体 类 型 或 第 二 个 参数 类 型 不 是 相应 实体 的 有 效 主键 类 
型 ,方法 将 抛 出 java. lang. IllegalArgumentException 型 例外 。 

代码 清单 12-2 演示 了 find 方法 的 使 用 。 其 中 luntanPU 是 持久 性 单元 的 名 称 ,Client 
是 一 个 实体 类 。 用 户 名 (username) 是 Client 实体 类 的 主键 。findClientByName 方法 接收 
客户 的 用 户 名 , 若 数据 库 中 存在 相应 的 客户 记录 或 者 持久 性 上 下 文中 有 相应 的 Client 实例 ， 
方法 返回 相应 的 Client 实例 ,否则 方法 返回 null。 

代码 清单 12-2 find 方法 使 用 示例 


public Client findClientByName (String username){ 
EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPU"); 


EntityManager em=emf .createEntityManager (); 


em.close(); 
emf.close(); 


1, 
2 
| 
4. Client client=em.find(Client.class,username); 
5 
6 
染 return client; 
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从 数据 库 查 找 (find) 或 查询 到 的 实体 包含 一 些 列 的 持久 性 数据 ,如 一 个 客户 的 密码 、 性 
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别 以 及 他 发 表 的 主题 等 。 这 些 数据 的 获取 存在 两 种 模式 : 预先 获取 (eager fetch) 和 延迟 获 
取 (lazy fetch) 。 预 先 获取 是 指 在 检索 或 查询 实体 时 即 加载 相 应 数据 ;延迟 获取 是 指 不 在 检 
索 或 查询 时 即时 加 载 , 而 是 在 需要 (被 访问 ) 时 再 加 载 相 应 数据 。 枚 举 类 型 FetchType 定义 
了 这 两 种 获取 模式 : 

。 FetchType. EAGER. 

。 FetchType. LAZY., 

第 11 章 曾 介绍 ,实体 类 中 反映 基本 映射 的 持久 性 变量 通常 用 @Basic 标注 修饰 ,该 标注 
的 fetch 属性 可 以 指定 持久 性 变量 值 的 获取 模式 ,默认 情况 下 取 FetchType. EAGER。 

除了 @Basic 标注 ,用 于 修饰 关系 变量 的 一 些 标注 也 包含 fetch 属性 。 利 用 fetch 属性 
可 以 指定 这 些 关系 变量 的 获取 模式 。 其 中 ,@OneToOne 和 @ManyToOne 标注 中 fetch 属 
性 的 默认 值 为 FetchType. EAGER, 而 @OneToMany 和 @IManyToMany 标注 中 fetch 属性 
的 默认 值 为 FetchType. LAZY。 也 就 是 说 在 默认 情况 下 , 当 检 索 到 的 一 个 实体 包含 单个 相 
关 实 体 时 ,就 预先 加 载 该 相关 实体 , 当 检索 到 的 一 个 实体 可 能 包含 多 个 相关 实体 时 ,就 延迟 
加 载 这 些 相关 实体 。 

3. 持久 实体 实例 

要 插入 新 的 数据 记录 可 以 调用 EntityManager 的 persist 方法 。persist 方法 使 一 个 新 
的 实体 实例 成 为 受 管理 的 。 受 管理 的 实体 实例 会 在 所 在 事务 递交 前 或 执行 flush 操作 时 保 
存 到 数据 库 中 。persist 方法 的 方法 签名 如 下 : 


public void persist (Object entity) 


使 用 说 明 : 

(1) 调用 方法 时 必须 指定 一 个 实体 实例 ,否则 将 抛 出 java. lang. IllegalArgumentException 
型 例外 。 

(2) 若 指定 的 实体 实例 原先 就 是 受 管理 的 , 则 该 操作 被 忽略 , 即 实体 实例 仍 保持 受 管 
理 的 。 

(3) 若 指定 的 实体 实例 原先 是 删除 的 ,那么 该 实体 实例 将 成 为 受 管理 的 。 

(4) 若 指定 的 实体 实例 是 分 离 的 ,方法 将 抛 出 EntityExistsException 型 例外 ,或 者 在 事 
务 递交 或 执行 flush 操作 时 , 抛 出 EntityExistsException 型 例外 或 其 他 PersistenceException 型 
例外 。 

PersistenceException 是 持久 性 提供 器 抛 出 的 各 种 例外 类 型 的 超 例外 类 型 ,该 例外 类 型 
与 java. lang. IllegalArgumentException 一 样 ,都 是 运行 时 例外 。 

代码 清单 12-3 演示 了 persist 方法 的 使 用 。insertClient 方法 接收 一 个 Client 型 实体 实 
例 ,通过 persist 方法 将 其 纳入 持久 性 上 下 文 ,并 在 事务 递交 时 在 数据 库 中 插入 相应 的 记录 。 
车 persist 方法 没有 抛 出 例外 ,比如 方法 接收 的 是 一 个 新 的 实体 实例 且 各 持久 性 数据 都 符合 
要 求 ,方法 返回 true; 和 否则 ,方法 返回 false。 方 法 中 涉及 的 有 关 事务 处 理 的 内 容 会 在 12. 3 
节 做 进一步 介绍 。 

代码 清单 12-3 ”persist 方法 使 用 示例 


1. public boolean insertClient (Client client){ 


2. EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPU"); 
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EntityManager em=emf .createEntityManager (); 
boolean success=true; 
tt 
em.getTransaction() .begin(); 
em.persist(client); 


em.getTransaction() .commit (); 


io ~ au ww 


} catch (PersistenceException e){ 


10. success=false; 
11s } 

12. em.close(); 

13. emf.close(); 

14. return success; 
15. } 


若 进行 持久 操作 的 实体 实例 (包括 受 管理 的 实体 实例 ) 存 在 相关 的 实体 实例 , 且 关系 标 
注 ( 如 @OneToMany 等 ) 的 cascade 属性 被 设置 为 PERSIST 或 ALL, 则 进行 层 和 到 持久 操 
作 , 即 相关 的 实体 实例 也 进行 持久 操作 。 

层 释 操作 的 类 型 在 枚 举 类 型 CascadeType 中 定义 , 共 包 含 6 个 枚 举 常量 ， 

。 CascadeType. ALL: 把 对 实体 的 所 有 操作 传播 到 相关 实体 。 

。 CascadeType. PERSIST: 把 对 实体 的 persist 操作 传播 到 相关 实体 。 

。 CascadeType. REMOVE: 把 对 实体 的 remove 操作 传播 到 相关 实体 。 

。 CascadeType. MERGE: 把 对 实体 的 merge 操作 传播 到 相关 实体 。 

。 CascadeType. REFRESH: 把 对 实体 的 refresh 操作 传播 到 相关 实体 。 

。 CascadeType. DETACH: 把 对 实体 的 detach 操作 传播 到 相关 实体 。 

关系 标注 (包括 @OneToMany、@OneToOne、@ManyToOne 和 @ManyToMany 等 ) 都 
有 一 个 cascade 属性 。 该 属性 的 类 型 是 CascadeType[ ], 所 以 可 以 指定 多 个 层 芭 操作 类 型 
值 ,如 cascade 二 {CascadeType. PERSIST, CascadeType. REMOVE)}。 

对 所 有 的 关系 标注 ,其 cascade 属性 的 默认 值 为 空 , 即 不 会 把 任何 对 实体 的 操作 传播 到 
相关 实体 。 通常 ,对 @OneToOne 标注 和 @OneToMany 标注 ,其 cascade 属性 值 可 以 取 
CascadeType. ALL, 对 @ManyToOne 标注 和 @ManyToMany 标注 ,其 cascade 属性 值 则 取 
默认 值 。 

4. 合并 实体 实例 

EntityManager 的 merge 方法 可 用 于 更 新 一 个 实体 实例 及 其 相关 实体 实例 的 持久 性 数 
据 。merge 方法 将 一 个 分 离 的 实体 实例 的 状态 纳入 到 相同 身份 的 已 存在 或 新 建 的 受 管理 的 
实体 实例 中 ,方法 返回 受 管理 的 实体 实例 。 

merge 方法 的 方法 签名 如 下 : 


public <T>T merge (T entity) 


使 用 说 明 : 
(1) 调用 方法 时 ,必须 指定 一 个 实体 实例 参数 。 如 果 指 定 的 参数 不 是 实体 类 型 对 象 ,将 
抛 出 java. lang. IllegalArgumentException 型 例外 。 
(2) 方法 调用 后 ,指定 的 实体 实例 仍然 是 分 离 的 ,而 方法 返回 的 实体 实例 是 受 管理 的 。 
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(3) 若 指定 的 实体 实例 是 新 的 , 则 新 建 一 个 受 管 理 的 实体 实例 ,并 将 指定 实体 实例 的 状 
态 纳入 该 新 建 的 受 管理 的 实体 实例 。 方 法 返回 新 建 的 受 管理 的 实体 实例 。 

(4) 若 指 定 的 实体 实例 是 删除 的 ,方法 抛 出 一 个 IlegalArgumentException 型 例外 。 

(5) 若 指定 的 实体 实例 本 来 是 受 管理 的 , 则 该 操作 被 忽略 。 

若 进行 合并 操作 的 实体 实例 (包括 受 管理 的 实体 实例 ) 存 在 相关 的 实体 实例 , 且 关系 标 
注 (如 @OneToMany、@OneToOne 等 ) 的 cascade 属性 被 设置 为 MERGE 或 ALL, 则 进行 
层 释 合并 操作 , 即 相关 的 实体 实例 也 进行 合并 操作 。 

5. 删除 实体 实例 

要 从 数据 库 中 删除 一 条 记录 ,可 以 先 获 得 该 记录 相应 的 受 管理 实体 实例 ,然后 再 调用 
EntityManager 的 remove 方法 。remove 方法 使 一 个 受 管理 的 实体 实例 成 为 删除 的 ,删除 
的 实体 实例 相应 的 数据 记录 会 在 所 在 事务 递交 前 或 执行 flush 操作 时 从 数据 库 中 删除 。 

remove 方 法 的 方法 签名 如 下 : 


Public void remove (Object entity) 


使 用 说 明 : 

(1) 调用 方法 时 ,必须 指定 一 个 实体 实例 参数 。 如 果 指 定 的 参数 不 是 实体 类 型 对 象 ,将 
抛 出 java. lang. IllegalArgumentException 型 例外 。 

(2) 若 指定 的 实体 实例 是 新 的 , 则 该 操作 被 忽略 , 即 该 实体 实例 仍然 是 新 的 。 

(3) 若 指定 的 实体 实例 是 删除 的 , 则 该 操作 被 忽略 , 即 该 实体 实例 仍然 是 删除 的 。 

(4) 若 指 定 的 实体 实例 是 分 离 的 ,方法 将 抛 出 IllegalArgumentException 型 例外 。 

若 进行 删除 操作 的 实体 实例 是 新 的 或 受 管理 的 .并 存在 相关 的 实体 实例 , 且 关 系 标 注 
(如 @OneToMany、@OneToOne) 的 cascade 属性 被 设置 为 REMOVE 或 ALL, 则 进行 层 释 
持久 操作 , 即 相 关 的 实体 实例 也 进行 删除 操作 。 

代码 清单 12-4 演示 了 merge 和 remove 方法 的 使 用 。 方 法 接收 一 个 分 离 Client 型 实体 
实例 ,并 将 其 纳入 持久 性 上 下 文 ,然后 通过 remove 方法 从 数据 库 中 删除 该 实体 实例 相应 的 
客户 记录 以 及 与 该 客户 记录 相关 的 标题 记录 和 回复 记录 。 这 里 ,假设 Client 实体 类 所 有 关 
系 变量 (包括 replyCollection topicCollection 和 topicCollectionl ) 的 @OneToMany 标注 的 
cascade 属性 值 都 为 CascadeType. ALL 或 CascadeType. REMOVE。 

代码 清单 12-4 ”merge 和 remove 方法 使 用 示例 


. public void delete (Client client){ 
EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPU"); 
EntityManager em=emf .createEntityManager (); 


try{ 


1 
2 
3 
4 
5。 em.getTransaction() .begin(); 
6 Client c=em.merge (client); 

人 em.remove (c); 

8 em.getTransaction() .commit (); 
9 }catch (Exception p){ 

10. } 

ll. em.close(); 
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6. 分 离 实体 实例 

EntityManager 的 detach 方法 使 一 个 受 管理 的 实体 实例 或 删除 的 实体 实例 脱离 持久 性 
上 下 文 ,成 为 分 离 的 实体 实例 。 该 方法 不 会 让 持久 性 上 下 文 执行 刷新 数据 库 操作 , 即 被 分 离 
的 实体 实例 及 其 状态 数据 不 会 同步 至 数据 库 。 

detach 方法 的 方法 签名 如 下 : 


public void detach (Object entity) 


使 用 说 明 : 

(1) 调用 方法 时 ,必须 指定 一 个 实体 实例 参数 。 如 果 指 定 的 参数 不 是 实体 类 型 对 象 ,将 
抛 出 java. lang. IllegalArgumentException 型 例外 。 

(2) 若 指定 的 实体 实例 是 新 的 , 则 该 操作 被 忽略 , 即 该 实体 实例 仍然 是 新 的 。 

(3) 若 指定 的 实体 实例 是 分 离 的 , 则 该 操作 被 忽略 , 即 该 实体 实例 仍然 是 分 离 的 。 

若 进行 分 离 操作 的 实体 实例 存在 相关 的 实体 实例 , 且 关 系 标 注 ( 如 @OneToMany 等 ) 
的 cascade 属性 被 设置 为 DETACH 或 ALL: 则 进行 层 释 持 久 操作 , 即 相关 的 实体 实例 也 进 
行 分 离 操作 。 

7. 刷新 数据 库 

刷新 数据 库 是 指 将 受 管 的 实体 实例 状态 同步 至 数据 库 ,或 从 数据 库 中 移 去 删除 实体 实 
例 对 应 的 数据 记录 。 刷 新 模式 有 两 种 ,定义 在 枚 举 类 型 FlushModeType 中: 

。 FlushModeType. AUTO., 

。 Flush ModeType. COMMIT. 

默认 情况 下 ,刷新 模式 为 FlushModeType. AUTO。 此 时 ,持久 性 提供 器 会 根据 需要 自 
动 执行 刷新 数据 库 操 作 ,一 般 发 生 在 事务 提交 前 或 在 实体 管理 器 产生 的 查询 对 象 上 执行 查 
询 操作 前 。 

可 以 调用 EntityManager 的 setFlushMode 方 法 改变 刷新 模式 。 比 如 下 面 代 码 将 刷新 
模式 设置 为 FlushModeType. COMMIT: 


em.setFlushMode (FlushModeType .COMMIT); 


当 刷 新 模式 为 FlushModeType. COMMIT 时 .持久 性 提供 器 就 只 在 事务 提交 前 执行 刷 
新 数据 库 操作 。 

无 论 是 哪 种 刷新 模式 ,都 可 以 在 需要 时 调用 EntityManager 的 flush 方法 显 式 操作 刷新 
数据 库 操作 。flush 方法 的 方法 签名 如 下 : 


public void flush() 


一 旦 调用 此 方法 ,持久 性 提供 器 就 会 把 每 个 受 管理 的 实体 实例 的 状态 同步 到 数据 库 ,也 
会 将 删除 实体 实例 对 应 的 数据 记录 从 数据 库 中 移 去 。 
flush 方法 只 能 在 事务 活动 的 情况 调用 ,和 否则 将 抛 出 TransactionRequiredException 型 
例外 。 如 果 不 存在 活动 的 事务 ,持久 性 提供 器 不 会 进行 刷新 数据 库 操作 ,包括 在 执行 查询 操 
作 前 。 
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8. 刷新 实体 实例 

刷新 实体 实例 是 指 用 数据 库 数 据 重 置 一 个 受 管理 的 实体 实例 的 状态 。EntityManager 
的 refresh 方法 可 以 实现 这 一 操作 ,该 方法 的 方法 签名 如 下 : 

public void refresh (Object entity) 

使 用 说 明 : 

(1) 如 果 指 定 的 参数 对 象 不 是 一 个 实体 实例 ,或 不 是 一 个 受 管理 的 实体 实例 ,方法 将 抛 
出 一 个 IllegalArgumentException 型 例外 。 

(2) 如 果 数 据 库 中 不 存在 与 指定 实体 实例 有 相同 身份 的 实体 记录 ,方法 将 抛 出 一 个 
EntityNotFoundException 型 例外 。 

若 进行 刷新 操作 的 实体 实例 存在 相关 的 实体 实例 , 且 关 系 标注 (如 @OneToMany 等 ) 
的 cascade 属性 被 设置 为 REFRESH 或 ALL, 则 进行 层 琶 持久 操作 , 即 相关 的 实体 实例 也 
进行 刷新 操作 。 

9. 清空 持久 性 上 下 文 

EntityManager 的 clear 方法 使 与 持久 性 上 下 文 相关 联 的 实体 实例 (包括 受 管理 的 和 删 
除 的 ?成 为 分 离 的 实体 实例 。clear 方 法 的 方法 签名 如 下 : 


public void clear1() 


该 方法 不 会 让 持久 性 上 下 文 执行 刷新 数据 库 操作 , 即 实体 实例 的 新 状态 不 会 同步 至 数据 库 ， 
与 删除 的 实体 实例 同 身份 的 实体 记录 也 不 会 从 数据 库 移 去 。 


12.3 事务 控制 


除 查找 (find) 、 查 询 (Query) 等 访问 操作 外 ,其 他 涉及 实体 实例 新 建 、 更 新 和 删除 等 的 操 
作 一 般 都 应 该 在 事务 内 执行 ,以 便 在 事务 递交 时 ,能 将 新 建 更 新 和 删除 的 实体 实例 同步 至 
数据 库 。 

本 地 资源 型 事务 的 控制 在 应 用 程序 编程 接口 EntityTransaction 中 定义 。 每 个 本 地 资 
源 型 实体 管理 器 (EntityManager) 对 象 都 对 应 有 一 个 EntityTransaction 型 对 象 ,调用 实体 管 
理 器 对 象 的 getTransaction 方法 可 以 返回 该 EntityTransaction 型 对 象 。EntityTransaction 接口 
的 常用 方法 如 表 12-2 所 示 。 

表 12-2 EntityTransaction 接口 的 常用 方法 

描 述 pi 法 描 述 
开始 一 个 本 地 资源 事务 Void rollback() 回 滚 当前 事务 
递交 当前 事务 boolean isActive() 检测 事务 是 否 在 进行 中 


方法 


Void begin() 


Void commit() 


对 于 一 个 EntityTransaction 型 对 象 ,可 以 依次 执行 多 个 事务 。 每 个 事务 由 调用 begin 
方法 开始 ,到 调用 commit 或 rollback 方法 结束 。 在 此 期 间 ,isActive 方法 返回 true, 表 明 事 
务 正 在 进行 中 。 

如 果 在 调用 begin 方法 时 事务 已 在 进行 中 ,或 者 在 调用 commit 或 rollback 方法 时 事务 
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没有 在 进行 中 ,都 将 抛 出 IllegalStateException 例外 。 
12.4 JPQL 


Java 持久 性 查询 语言 (JPQL) 用 于 定义 基于 实体 的 查询 ,以 及 批量 更 新 和 删除 操作 。 
JPQL 与 SQL 的 语法 非常 相似 ,但 JPQL 查询 的 主体 是 实体 和 实例 变量 ,而 非 表 和 列 。 它 使 
应 用 程序 开发 者 可 以 定义 独立 于 底层 数据 库 、 可 移植 的 查询 语句 , 当 实 体 映射 被 改变 时 ,不 
需要 改动 JPQL 查询 。 

JPQL 支持 基于 @NamedQuery 标注 的 静态 查询 ,也 支持 在 运行 时 构建 并 处 理 的 动态 
查询 。 无 论 是 静态 查询 还 是 动态 查询 ,都 可 以 采用 参数 绑 定 。 

JPQL 语句 包括 SELECT 语句 `UPDATE 语句 和 DELETE 语句 。 


12.4.1 SELECT 语句 格式 


SELECT 语句 由 SELECT 子 句 .FROM 子 句 、WHERE 子 名 .GROUP BY 子 句 .HAVING 
子 句 和 ORDER BY 子 句 组 成 ,其 中 SELECT 子 句 和 FROM 子 句 是 必需 的 ,其 他 子 句 是 可 
选 的 。 

<SELECT 子 句 ><FROM 子 句 > [<WHERE 子 句 >] 

[<GROUP BY 子 句 >] [<HAVING 子 句 >] [<ORDER BY 子 句 >] 


说 明 : 在 JPQL 语法 格式 中 ,符号 二 > 表示 该 项 应 根据 需要 和 情况 具体 指定 ;符号 [] 表 
示 该 项 为 可 选项 。 


12.4.2 标识 变量 


标识 变量 表示 某 种 实体 类 型 的 一 个 实例 。 标 识 变 量 是 在 FROM 子 句 中 声明 的 一 个 标 
识 符 。 标 识 变 量 只 能 在 FROM 子 句 中 声明 ,不 能 在 其 他 子 句 中 声明 ,但 通常 会 在 其 他 子 句 
中 使 用 。 

标识 变量 不 能 与 SELECT、UPDATE、DELETE、AS、FROM 等 JPQL 的 保留 字 同 名 ， 
也 不 能 是 同一 持久 性 单元 中 某 个 实体 类 型 名 。 在 JPQL 中 ,标识 变量 和 保留 字 都 是 不 区 分 
大 小 写 的 。 

有 三 种 格式 可 以 声明 标识 变量 : 范围 变量 声明 JOIN 短语 以 及 集合 成 员 声明 。 

1. 范围 变量 声明 

范围 变量 声明 定义 一 个 表示 指定 实体 类 型 实体 的 标识 变量 。 范 围 变量 声明 的 语法 格式 
如 下 : 


< 实体 类 型 > [AS] < 标识 变量 > 


下 面 语句 可 以 查询 所 有 的 客户 ,其 中 FROM 子 句 中 声明 了 一 个 名 为 c 的 标识 变量 , 表 
示 一 个 客户 实体 。 


SELECT c FROM Client RS c 


或 
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SELECT c FROM Client c 


2. JOIN 短语 

JOIN 短语 总 是 紧 跟 在 范围 变量 声明 或 其 他 JOIN 短语 之 后 (相互 之 间 用 空格 分 隔 ), 用 
于 声明 一 个 表示 与 之 前 已 定义 的 标识 变量 相关 的 实体 的 标识 变量 。JOIN 短语 的 语法 格式 
如 下 : 

[LEFT [OUTER] |INNER] JOIN 

{< 标识 变量 > .< 单 值 关 系 变量 > |< 标 识 变量 > .< 集合 值 关 系 变量 >} 

[AS] < 标识 变量 > 
这 里 ,JOIN 或 INNER JOIN 表示 内 连接 ,LEFT JOIN 或 LEFT OUTER JOIN 表示 左 连 
接 。 与 SQL 中 的 JOIN 短语 相 比 较 ,JPQL 中 的 JOIN 短语 隐 含 有 连接 条 件 , 即 查询 的 是 相 
关 的 实体 ,而 不 会 把 无 关 的 实体 连接 在 一 起 。 

说 明 : 在 JPQL 语法 格式 中 ,符号 | 可 以 将 两 项 或 多 项 连接 起 来 ,表示 选择 其 中 一 项 。 
为 标明 第 一 项 的 开始 处 及 最 后 一 项 的 结尾 处 ,可 用 符号 {}) 将 这 些 选项 括 起 来 。 

下 面 语句 查询 所 有 发 布 过 主题 的 客户 。FROM 子 句 中 声明 了 两 个 标识 变量 : c 和 t。c 
表示 一 个 客户 实体 ,t 表示 一 个 相关 的 主题 实体 。 这 里 ,表达 式 c. topicCollection 引用 了 之 
前 已 经 声明 的 标识 变量 c,topicCollection 是 Client 实体 类 中 定义 的 一 个 集合 值 关 系 变量 ， 
点 是 导航 运算 符 , 表 示 从 一 个 客户 导航 至 与 其 相关 的 一 组 主题 实体 。 


SELECT DISTINCT c FROM Client c JOIN c.topicCollectiont 
说 明 : 上 述 JPQL SELECT 语句 的 功能 与 下 面 的 SQL SELECT 语句 相当 : 


SELECT DISTINCT C . 类 
FROM TOPIC t 上 ,CLIENT c WHERE (t .username=c.username) 


上 述 语句 的 查询 功能 也 可 以 用 下 面 语句 等 价 实现 。 
SELECT c FROM Client c WHERE c.topicCollection IS NOT EMPTY 
说 明 : 上 述 JPQL SELECT 语句 的 功能 与 下 面 的 SQL SELECT 语句 相当 : 


SELECT * 
FROM CLIENT c 
WHERE ( (SELECT COUNT (t .ID) FROM TOPIC t WHERE (t.USERNRAME=c.USERNRME)) >0) 


3. 集合 成 员 声 

集合 成 员 声 明定 义 一 个 表示 某 实体 集合 中 一 个 成 员 的 标识 变量 。 集 合成 员 声 明 的 语法 
格式 如 下 ,其 中 的 集合 值 路 径 表 达 式 表示 某 实体 集合 : 

IN (< 集合 值 路 径 表 达 式 >) [AS] < 标识 变量 > 

下 面 语句 实现 与 上 面 *JOIN 短语 ”中 介绍 的 语句 相同 的 功能 , 即 查询 所 有 发 布 过 主题 
的 客户 。 


SELECT DISTINCT c FROM Client c, IN (c.topicCollection) 七 
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12.4.3 路 径 表 达 式 


路 径 表 达 式 在 前 面 JOIN 短语 和 集合 成 员 声 明 中 已 经 出 现 过 (c. topicCollection), 它 可 
以 通过 实体 类 中 的 关系 变量 定义 实体 之 间 的 导航 路 径 。 在 JPQL 中 ,路径 表达 式 是 一 个 重 
要 的 语法 成 分 , 它 可 能 出 现在 SELECT 语句 的 各 个 子 句 中 ,也 会 用 于 UPDATE 和 
DELETE 语句 中 。 

路 径 表 达 式 分 为 单 值 路 径 表 达 式 和 集合 值 路 径 表 达 式 , 单 值 路 径 表 达 式 又 分 为 单 值 关 

1. 单 值 关系 路 径 表 达 式 

单 值 关系 路 径 表 达 式 的 语法 格式 如 下 : 

< 标识 变量 > .{< 单 值 关 系 变量 > . } * < 单 值 关 系 变 量 > 

说 明 : 在 JPQL 语法 格式 中 ,符号 {} * 表示 该 项 可 重复 0 至 多 次 。 

下 面 语句 查询 由 用 户 名 为 “zhaoyy” 的 客户 发 布 的 主题 的 所 有 回复 。 这 里 ,WHERE 子 
名 中 的 r. topic. client 是 一 个 单 值 关系 路 径 表达 式 , 其 中 rz 是 一 个 Reply 类 型 的 标识 变量 ， 
topic 是 Reply 实体 类 中 定义 的 一 个 Topic 类 型 的 单 值 关系 变量 ,client 是 Topic 实体 类 中 
定义 的 一 个 Client 类 型 的 单 值 关 系 变量 。 


SELECT r FROM Reply r,Client c WHERE r.topic.client=c AND c.username= 'zhaoyy' 
说 明 : 上 述 JPQL SELECT 语句 的 功能 与 下 面 的 SQL SELECT 语句 相当 : 


SELECT r.* 
FROM CLIENT c, REPLY r,TOPIC 七 
WHERE ((c.USERNAME="'zhaoyy') AND ((t.ID=r.TOPID) AND (c.USERNAME=t .USERNAME))) 


2. 状态 变量 路 径 表达 式 

状态 变量 路 径 表 达 式 的 格式 如 下 : 

{< 标识 变量 > .< 状态 变量 > |< 单 值 关系 路 径 表 达 式 > .< 状态 变量 >} 

下 面 语句 实现 与 上 面 “ 单 值 关系 路 径 表 达 式 "中 介绍 的 语句 相同 的 功能 , 即 查 询 由 用 户 
名 为 “zhaoyy” 的 客户 发 布 的 主题 的 所 有 回复 。 这 里 ,r. topic. client. username 是 一 个 状态 
变量 路 径 表 达 式 ,其 中 rf 是 标识 变量 ,topic 和 client 都 是 单 值 关系 变量 ,username 是 Client 
实体 类 中 定义 的 持久 性 状态 变量 。 

SELECT r FROM Reply r WHERE r.topic.client.username="'zhaoyy'" 


3. 集合 值 ( 关 系 ) 路 径 表 达 式 
集合 值 (关系 ) 路 径 表 达 式 的 格式 如 下 : 
< 标识 变量 > . {< 单 值 关系 变量 > .} * < 集合 值 关系 变量 > 
下 面 语句 查询 既 没有 发 表 主题 也 没有 对 任何 主题 作 过 回复 的 客户 。 这 里 ,WHERE 子 
名 中 的 c. topicCollection 和 c. replyCollection 都 是 集合 值 路 径 表 达 式 。 其 中 ec 是 一 个 
Client 类 型 的 标识 变量 ,topicCollection 和 replyCollection 都 是 Client 实体 类 中 定义 的 集合 
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值 关 系 变量 。 
SELECT c FROM CLIENT c WHERE c.topicCollection IS EMPTY AND c.replyCollection IS EMPTY 
说 明 : 上 述 JPQL SELECT 语句 的 功能 与 下 面 的 SQL SELECT 语句 相当 : 


SELECT c.* 

FROM CLIENT c 

WHERE ( 
( (SELECT COUNT (t .ID) FROM TOPIC t WHERE (t.USERNAME=c.USERNAME))=0) 
AND 
( (SELECT COUNT (r .ID) FROM REPLY r WHERE (r.USERNAME=c.USERNAME))=0)) 


从 上 面 的 语法 格式 可 以 看 出 ,在 路 径 表 达 式 中 ,由 单 值 关系 变量 可 以 导航 至 状态 变量 、 
其 他 的 单 值 关 系 变量 或 者 集合 值 关系 变量 ,但 由 状态 变量 或 集合 值 关 系 变 量 则 无 法 导航 至 
其 他 的 元 素 。 

每 个 路 径 表 达 式 都 有 确切 的 Java 类 型 。 路 径 表 达 式 的 类 型 由 路 径 表 达 式 中 最 后 一 个 
元 素 的 类 型 确定 ,如 状态 变量 路 径 表 达 式 r.topic. client. username 的 类 型 是 状态 变量 
username 的 类 型 ,集合 值 路 径 表 达 式 c. topicCollection 的 类 型 是 集合 值 关系 变量 topicCollection 
的 类 型 。 


12.4.4 FROM 子 句 
FROM 子 句 指定 查询 的 范围 ,其 语法 格式 如 下 : 


FROM < 范围 变量 声明 > {JOIN 短语 } x {,{< 范 围 变量 声明 > {JoIN 短语 } * 1< 集 合成 员 声 明 > } } * 


FROM 子 句 由 一 些 标识 变量 声明 组 成 : 首先 是 范围 变量 声明 ,然后 可 以 跟 0 至 多 个 范 
围 变量 声明 或 集合 成 员 声 明 ,两 者 之 间 用 逗号 分 隔 。 每 个 范围 变量 声明 后 可 跟 0 至 多 个 
JOIN 短语 ,JOIN 短语 可 看 作 是 范围 变量 声明 的 附属 。 


12.4.5 SELECT 子 句 


SELECT 子 句 指定 查询 结果 的 类 型 ,其 语法 格式 如 下 : 
SELECT [DISTINCT] <SELECT 表达 式 >{,<SELECT 表达 式 >]} * 


其 中 ,可 选项 DISTINCT 表示 从 查询 结果 中 消除 重复 项 ,SELECT _ 表 达 式 的 类 型 确定 
了 查询 返回 的 那些 对 象 或 值 的 类 型 。SELECT 子 句 可 以 包含 1 个 或 多 个 SELECT 表达 
式 。 如 果 仅 包含 一 个 SELECT 表达 式 ,查询 返回 的 对 象 或 值 的 类 型 即 为 该 表达 式 的 类 型 。 
如 果 包 含 多 个 SELECT _ 表达 式 ,查询 返回 的 对 象 或 值 的 类 型 为 Object[], 其 中 各 元 素 的 次 
序 和 具体 类 型 与 子 句 中 列 出 的 各 表达 式 对 应 。 

SELECT _ 表达 式 可 以 是 以 下 语法 成 分 : 

。 标识 变量 。 

。 单 值 路 径 表 达 式 。 

。 聚合 表达 式 。 

。 构造 方法 表达 式 。 
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使 用 聚合 函数 可 以 先 对 查询 的 初始 结果 进行 计算 ,然后 再 返回 最 终 的 查询 结果 。 聚 合 
表达 式 的 语法 格式 如 下 : 


{AVG|MAX|IMIN|1SUM} ( [DISTINCT] < 状态 变量 路 径 表 达 式 >) | 
COUNT ( [DISTINCT] {< 标识 变量 > |< 状 态 变 量 路 径 表 达 式 > |< 单 值 关 系 路 径 表 达 式 >}) 


表 12-3 列 出 了 用 于 聚合 表达 式 中 的 聚合 函数 的 特性 。 


表 12-3 聚合 函数 的 特性 


功 能 


AVG | 计算 平均 什 Double 

COUNT | 计数 Long 

MAX | 计算 最 大 值 其 应 用 的 状态 变量 路 径 表 达 式 的 类 型 
MIN 计算 最 小 值 其 应 用 的 状态 变量 路 径 表 达 式 的 类 型 


Long Double .BigInteger 或 BigDecimal 


使 用 聚合 函数 进行 查询 和 计算 时 ,如 果 没 有 查询 结果 可 用 于 计算 ,那么 对 于 AVG、 
MAX MIN 和 SUM 函数 ,计算 结果 为 null, 对 于 COUNT 函数 ,计算 结果 为 0。 
下 面 语句 查询 在 线 (status 值 为 1) 用 户 的 人 数 ,查询 结果 是 一 个 Long 型 实例 对 象 。 


SELECT COUNT (c) FROM Client c WHERE c.status= "1" 
构造 方法 表达 式 的 格式 如 下 : 
NEW < 构造 方法 名 > (< 构造 项 >{,< 构 造 项 >} x ) 


其 中 ,构造 方法 名 也 即 类 名 ,构造 项 可 以 是 单 值 路径 表 达 式 或 聚合 表达 式 。 使 用 构造 方法 表 
达 式 ,可 以 使 查询 返回 一 个 或 多 个 指定 类 的 实例 对 象 ,而 不 是 一 个 或 多 个 Objecc[ ] 型 对 象 ， 
从 而 更 便于 后 续 处 理 。 指 定 的 类 不 必 映 射 到 数据 库 , 也 不 必 是 实体 类 。 


12.4.6 WHERE 子 名 
WHERE 子 句 指定 查询 .更 新 或 删除 的 条 件 ,其 基本 的 语法 格式 如 下 : 
WHERE < 条 件 表达 式 > 


条 件 表达 式 由 文字 标识 变量 、 路 径 表 达 式 .输入 参数 与 各 种 运算 符 连接 组 成 ,其 类 型 应 
该 是 布尔 型 。 表 12-4 列 出 了 JPQL 支持 的 各 种 运算 符 及 其 优先 级 。 


表 12-4 JPQL 运算 符 及 其 优先 级 


分 类 运 算 符 优先 级 

导航 运算 符 | | i! 
|+.—o¥) | 2 

算术 运算 符 | x* ./ (乘除 ) | 
十 ` 一 (加 \ 减 ) 4 


分 类 运 算 符 优先 级 
=.>.>=.<.<=.<> 

关系 运算 符 | [NOT] BETWEEN [LNOT] LIKE 5 
[NOT] IN\IS [NOT] NULLIS [NOT] EMPTY.[NOT] MEMBER [OF] 
NOT 6 

逻辑 运算 符 | AND 7 
OR 8 


1. BETWEEN 表达 式 

使 用 BETWEEN 表达 式 可 以 测试 某 表 达 式 的 值 是 否 落 在 指定 的 区 间 , 其 语法 格式 
如 下 : 

< 测试 表达 式 > [NOT] BETWEEN < 起 始 值 表达 式 >AND < 终止 值 表达 式 > 
其 中 ,三 个 表达 式 的 类 型 必须 相同 ,可 以 是 数值 型 ,也 可 以 是 字符 串 或 日 期 时 间 型 。 

下 面 两 个 BETWEEN 表达 式 的 功能 相当 : 


t.clickcount BETWEEN 100 AND 200 
t.clickcount>=100 AND t.clickcount<=200 


下 面 两 个 表达 式 也 具有 相同 的 功能 : 


t.clickcount NOT BETWEEN 100 AND 200 
t.clickcount<100 OR t.clickcount>200 


2. IN 表达 式 

使 用 IN 表达 式 可 以 测试 一 个 状态 变量 路 径 表 达 式 的 值 是 否 属于 某 个 值 列表 或 子 查 
询 ,其 语法 格式 如 下 : 

< 状态 变量 路 径 表 达 式 > [NOT] IN({<in 项 >{,<in 项 >} * 1< 子 查询 >}) 
其 中 in_ 项 可 以 是 以 下 语法 成 分 : 

。 文字。 

。 输入 参数 。 

下 面 表达 式 用 以 测试 一 个 客户 的 username 值 是 否 为 “liling”“zhaoyy” 或 “lilong”。 

c.username IN ('liling', 'zhaoyy', 'lilong') 

3. LIKE 表达 式 

使 用 LIKE 表达 式 可 以 进行 字符 串 的 匹配 查询 ,其 语法 格式 如 下 : 

< 字符 串 表达 式 > [NOT] LIKE {< 字符 串 文字 > |< 字 符 串 输入 参数 > } 

在 字符 串 文字 或 字符 串 输入 参数 中 ,下 划 线 (_) 代 表 任 意 单 个 字符 , 百 分 号 (%) 代 表 任 


意 的 字符 序列 (包括 空 ) 。 
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下 面 表达 式 测试 客户 的 邮箱 地 址 是 否 以 “163. com” 结 尾 。 
c.email LIKE "g%163.com' 


4. NULL 比较 表达 式 
用 于 测试 一 个 单 值 路 径 表 达 式 或 输入 参数 的 值 是 否 为 NULL 值 ,其 语法 格式 如 下 : 


{< 单 值 路 径 表 达 式 > |< 输 入 参数 >} IS [NOT] NULL 


5. 空 集合 比较 表达 式 : 
用 于 测试 一 个 集合 值 路 径 表 达 式 的 值 是 否 包 含 元 素 ,其 语法 格式 如 下 : 


< 集合 值 路 径 表 达 式 >IS [NOT] EMPTY 


如 果 集 合 值 路 径 表 达 式 的 值 本 身 为 NULL 值 , 则 整个 表达 式 的 值 也 为 NULL。 
下 面 语句 查询 所 有 已 有 回复 的 主题 。 


SELECT t FROM Topic t WHERE t.replyCollection IS NOT EMPTY 


6. 输入 参数 
在 WHERE 和 HAVING 子 句 中 ,可 以 引入 输入 参数 ,以 便 增加 查询 的 通用 性 和 灵活 
性 。JPQL 支持 两 种 类 型 的 输入 参数 : 命名 参数 和 位 置 参 数 。 
。 命名 参数 : 以 冒号 (:) 开 头 、 后 跟 一 个 字符 串 , 如 :name, 其 中 字符 串 作 为 输入 参数 的 
名 称 是 大 小 写 敏感 的 。 
。 位 置 参数 : 以 问号 (?) 开 头 、 后 跟 一 个 整数 ,如 : ?1, 其 中 整数 作为 输入 参数 的 编号 必 
须 大 于 等 于 1。 
在 同一 个 查询 中 ,可 以 引入 多 个 输入 参数 ,但 不 应 混合 使 用 命名 参数 和 位 置 参 数 。 不 同 
的 参数 应 该 有 不 同 的 名 称 或 编号 ,但 同一 个 参数 可 以 出 现 多 次 。 
关于 参数 的 设置 及 JPQL 语句 的 执行 请 参见 第 12. 5 节 。 
7. 集合 成 员 比 较 表 达 式 
用 于 测试 一 个 值 是 否 为 一 个 集合 的 成 员 , 其 中 被 测试 的 值 和 集合 成 员 必 须 有 相同 的 数 
据 类 型 。 其 语法 格式 如 下 : 


< 实体 表达 式 > [NOT] MEMBER [OF] < 集合 值 路 径 表 达 式 > 


这 里 ,实体 表达 式 可 以 是 单 值 关 系 路 径 表 达 式 、 标 识 变量 或 输入 参数 。 
下 面 语句 返回 包含 指定 回复 的 主题 。 


SELECT t FROM Topic t WHERE :reply MEMBER t.replyCollection 


8. EXISTS 表达 式 
使 用 EXISTS 表达 式 可 以 测试 一 个 子 查询 是 否 存在 查询 结果 .其 语法 格式 如 下 : 


[NOT] EXISTS (< 子 查 询 >) 
下 面 语 句 查询 所 有 没有 任何 回复 的 主题 。 
SELECT t FROM Topic t WHERE NOT EXISTS (SELECT r FROM Reply r WHERE r.topic=t) 


该 查询 的 查询 主体 是 主题 。 对 每 一 个 主题 . 主 查 询 向 子 查 询 提供 该 主题 , 子 查询 查找 所 
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有 属于 该 主题 的 回复 ,然后 主 查询 判断 子 查 询 是 否 存在 查询 结果 , 若 不 存在 , 则 当前 主题 是 
需要 查询 的 。 

9. ALL 或 ANY 表达 式 

该 表达 式 用 于 比较 主 查询 中 的 某 个 表达 式 值 与 子 查询 的 查询 结果 ,其 语法 格式 如 下 : 


< 表达 式 >< 比 较 运算 符 > {ALLIANY1SOME} (< 子 查 询 >) 


这 里 的 比较 运算 符 包 括 : 二 ,一 二 ,= 二、 二 和 二 = 二。 如 果 选 用 ALL, 那 么 只 有 主 查 询 中 
表达 式 值 与 子 查 询 的 所 有 查询 结果 都 符合 比较 要 求 .整个 表达 式 的 值 才 为 TRUE, 和 否则 整 
个 表达 式 的 值 为 FALSE。 如 果 选 用 ANY ,那么 主 查 询 中 表达 式 值 只 要 与 子 查询 的 某 个 查 
询 结果 符合 比较 要 求 ,整个 表达 式 的 值 就 为 TRUE, 只 有 当主 查询 中 表达 式 值 与 子 查询 的 
所 有 查询 结果 都 不 符合 比较 要 求 , 整 个 表达 式 的 值 才 为 FALSE。 关 键 字 ANY 与 SOME 是 
同义词 ,可 以 互相 替换 。 

下 面 语句 查询 最 新 发 布 的 主题 , 即 发 布 这 些 主题 后 还 没有 任何 客户 对 任何 主题 发 表 过 
回复 。 


SELECT t FROM Topic t WHERE 七 .createtime >ALL (SELECT r.replytime FROM Reply r) 

子 查询 从 回复 表 中 获取 所 有 回复 的 发 表 时 间 , 主 查询 从 主题 表 中 查询 所 有 创建 时 间 大 
于 子 查 询 获 得 的 所 有 时 间 的 主题 。 
12.4.7 GROUP BY 和 HAVING 子 句 

使 用 GROUP BY 子 句 可 以 对 实体 进行 分 组 汇总 查询 ,该 子 句 的 语法 格式 如 下 : 

GROUP BY < 单 值 路 径 表 达 式 > {,< 单 值 路 径 表达 式 >} * 
其 中 子 句 中 指定 的 单 值 路 径 表达 式 为 分 组 标识 , 即 在 这 些 表达 式 上 取 值 相同 的 实体 为 一 组 。 
分 组 汇总 查询 通常 会 利用 聚合 函数 对 每 一 组 实体 进行 计算 。 

下 面 语句 查询 各 类 文化 程度 (不 同 degree 值 ) 的 客户 人 数 。 

SELECT c .degree，COUNT (c) FROM Client c GROUP BY c.degree 

HAVING 子 句 总 是 与 GROUP BY 子 句 配合 使 用 ,用 于 指定 分 组 查询 的 条 件 , 即 哪些 
分 组 汇总 后 满足 查询 条 件 。 该 子 句 的 语法 格式 如 下 : 

HAVING < 条 件 表达 式 > 

当 SELECT 语句 中 既 包 含 WHERE 子 句 ,又 包含 GROUP BY 和 HAVING 子 句 时 ， 


首先 用 WHERE 子 句 过 滤 查 询 内 容 , 然 后 再 基于 GROUP BY 子 句 对 过 滤 后 的 内 容 进行 聚 
合计 算 ,最 后 用 HAVING 子 句 过 滤 聚 合 后 的 内 容 并 返回 最 终 的 查询 结果 。 


12.4.8 ORDER BY 子 名 


ORDER BY 子 句 用 于 对 查询 结果 按 指定 的 状态 变量 路 径 表达 式 的 值 进行 排序 ,该 子 名 
的 语法 格式 如 下 : 


ORDER BY < 状态 变量 路 径 表 达 式 > [ASC1DESC] {,< 状 态 变量 路 径 表 达 式 > [ASC1DESC] } * 
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如 果 指 定 了 多 个 状态 变量 路 径 表 达 式 ,那么 先 按 前 面 的 状态 变量 路 径 表 达 式 值 进行 排 
序 , 若 其 值 相同 ,再 按 后 面 的 状态 变量 路 径 表 达 式 值 进行 排序 。ASC 表示 升序 ,DESC 表示 
降序 ,其 中 ASC 是 默认 值 。 

下 面 语句 查询 所 有 主题 ,并 按 创建 时 间 对 主题 进行 降序 排序 , 即 后 发 布 的 主题 在 前 , 先 
发 布 的 主题 在 后 。 


SELECT t FROM Topic t ORDER BY 七 .createtime DESC 


12.4.9 UPDATE 和 DELETE 语句 


UPDATE 语句 可 以 实现 对 实体 的 批量 更 新 ,其 基本 语法 格式 如 下 : 


UPDATE < 实体 类 型 > [AS] < 标识 变量 > 
SET [< 标识 变量 > .]{< 状 态 变量 > |< 单 值 关系 变量 >}=< 新 值 > 
{v [< 标识 变量 > .] {< 状态 变量 > 1< 单 值 关系 变量 >}=< 新 值 >} * 

[WHERE < 条 件 表达 式 >] 
其 中 ,UPDATE 子 句 指定 要 更 新 的 实体 类 型 ,SET 短语 指定 更 新 的 具体 内 容 , WHERE 子 
句 指定 更 新 条 件 , 即 对 哪些 实体 进行 更 新 。WHERE 子 句 的 书写 规则 与 SELECT 语句 中 的 
相同 。 如 果 缺 省 WHERE 子 句 , 将 对 指定 类 型 的 所 有 实体 进行 更 新 。 

下 面 语句 对 所 有 由 “zhaoyy” 发 布 的 主题 的 clickcount( 点 击 数 ) 加 1。 


UPDATE Topic t SETt.clickcount=t.clickcount+1 WHERE 七 .client .username= 'zhaoyy' 
这 里 ,SET 短语 中 赋值 号 左边 状态 变量 或 单 值 关 系 变量 前 的 标识 变量 是 可 省 略 的 ,所 以 上 
面 语句 也 可 以 写成 如 下 。 

UPDATE Topic t SET clickcount=t .clickcount+1 WHERE t.client.username= 'zhaoyy' 

DELETE 语句 可 以 实现 对 实体 的 批量 删除 ,其 语法 格式 如 下 : 

DELETE FROM < 实体 类 型 > [AS] < 表示 变量 > [WHERE < 条 件 表达 式 >] 


其 中 ,DELETE 子 句 指定 要 删除 的 实体 类 型 ,WHERE 子 句 指定 删除 条 件 , 即 要 删除 哪些 实 
体 。 如 果 缺 省 WHERE 子 句 ,将 删除 指定 类 型 的 所 有 实体 。 


12.5 执行 JPQL 语句 


JPQL 虽然 在 语法 上 与 SQL 相似 ,但 并 不 能 在 数据 库 系 统 中 直接 执行 。JPQL 语句 的 
执行 首先 需要 被 转换 成 持久 性 提供 器 当前 相连 接 的 数据 库 系统 的 SQL 语句 ,然后 再 把 
SQL 语句 执行 后 返回 的 数据 装配 成 实体 实例 或 其 他 Java 对 象 返回 。 这 个 过 程 需要 持久 性 
提供 器 支持 ,并 通过 查询 API 实现 ,如 图 12-4 所 示 。 


12.5.1 基本 过 程 


在 JPA 中 ,执行 JPQL 语句 的 基本 步骤 如 下 : 
(1) 获得 实体 管理 器 对 象 ; 
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持久 性 提供 器 
图 12-4 JPQL 语句 的 执行 


(2) 创建 包含 JPQL 语句 的 查询 对 象 ; 

(3) 调用 查询 对 象 的 相关 方法 执行 查询 ; 

(4) 浏览 或 处 理 查 询 结果 (实体 ) 。 

要 利用 JPQL 进行 查询 ,首先 要 定义 JPQL 语句 。 这 里 有 两 种 定义 JPQL 语句 的 方式 。 
一 是 所 谓 的 动态 查询 , 即 在 程序 代码 中 创建 JPQL 语句 字符 串 ; 二 是 所 谓 静态 查询 或 命名 查 
询 ,是 指 用 @NamedQuery 标注 定义 JPQL 语句 并 对 其 命名 。 下 面 是 @NamedQuery 标注 
的 一 个 示例 ,其 中 query 属性 指定 了 JPQL 语句 ,name 属性 指定 了 名 称 。 


@NamedQuery (name= "Client.findAll",query="SELECT c FROM Client c") 


@NamedQuery 标注 应 该 修饰 于 实体 类 。 因 为 一 个 程序 元 素 只 能 有 某 种 标注 类 型 的 一 
个 标注 ,所 以 一 个 实体 类 也 只 能 有 一 个 @NamedQuery 标注 。 如 果 需 要 在 一 个 实体 类 中 定 
义 多 个 命名 查询 ,可 以 借助 @NamedQueries 标注 。@ NamedQueries 标注 仅 有 一 个 value 
属性 ,该 属性 的 类 型 是 @NamedQuery[ ,所 以 一 个 @NamedQueries 标注 可 以 包含 多 个 
@NamedQuery 标注 。 下 面 是 @NamedQueries 标注 的 一 个 示例 ,其 中 定义 了 三 个 命名 
查询 。 


@NamedQueries ({ 
@NamedQuery (name= "Client.findAll",query="SELECT c FROM Client c"), 
@NamedQuery (name= "Client.findByUsername", 
query="SELECT c FROM Client c WHERE c.username= :username"), 
@NamedQuery (name= "Client.findByStatus", 
query="SELECT c FROM Client c WHERE c.status=:status") 
}) 


需要 注意 的 是 ,在 一 个 持久 性 单元 范围 内 ,所 有 命名 查询 的 名 称 必须 是 唯一 的 。 

第 11 章 介 绍 的 通过 数据 库 自动 生成 的 实体 类 中 .类 的 标注 中 都 会 包含 有 关 该 实体 的 命 
名 查询 ,查询 的 名 称 就 如 上 述 例 子 一 样 , 都 由 相应 的 实体 类 名 来 限制 。 这 样 可 以 确保 持久 性 
单元 内 各 命名 查询 的 名 称 是 互 不 相同 的 。 

定义 好 了 JPQL 语句 ,就 可 以 按 上 述 步骤 执行 JPQL 语句 了 。 首 先 要 获得 实体 管理 器 
对 象 , 然 后 利用 实体 管理 器 创建 包含 JPQL 语句 的 查询 对 象 。 

下 面 是 一 些 用 于 创建 查询 对 象 的 EntityManager 方法 。 


。 public Query createQuery (String qlstring); 
创建 一 个 查询 对 象 ,用 于 执行 指定 的 JPQL 语句 。 


。 public <T>TypedQuery<T>createQuery (String qlString,Class<T>resultClass); 
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创建 一 个 类 型 化 的 查询 对 象 , 用 于 执行 指定 的 JPQL 语句 。 该 JPQL 语句 的 查询 结 
果 只 能 指定 单一 项 ,方法 的 第 2 个 参数 指定 该 单一 项 类 型 。 


Public Query createNamedQuery (String name) 7 


创建 一 个 查询 对 象 , 用 于 执行 指定 的 JPQL 命名 查询 。 


Public <T>Typedouery<T>createNamedouery (String name,Class<T>resultClass); 


创建 一 个 类 型 化 的 查询 对 象 ,用 于 执行 指定 的 JPQL 命名 查询 。 该 命名 查询 的 查询 
结果 只 能 指定 单一 项 ,方法 的 第 2 个 参数 指定 该 单一 项 类 型 。 
下 面 代码 共 创 建 了 四 个 查询 实例 : 两 个 是 动态 查询 实例 queryl 和 query3 ,另外 两 个 是 
命名 查询 实例 query2 和 query4。 在 这 里 ,动态 查询 中 包含 了 一 个 位 置 参 数 ? 1 ,命名 查询 中 
包含 了 一 个 命名 参数 :status。 


EntityManagerFactory emf=Persistence.createEntityManagerFactory("1untanPU") 7 
EntityManager em=emf .createEntityManager (); 
Query queryl=em.createQuery ("SELECT c FROM Client c WHERE c.useranme=?1") 7 
Query query2=em.createNamedQuery ("Client.findByStatus"); 
TypedQuery<Client>query3=em.createQuery!( 

"SELECT c FROM Client c WHERE c.useranme=?1",Client.class); 
TypedQuery<Client>query4=em.createNamedQuery ("Client .findByStatus",Client.class); 
em.close(); 


emf.close(); 

说 明 : 命名 查询 Client. findByStatus 的 定义 可 查看 通过 数据 库 自动 生成 的 Client 实体 
类 中 的 相关 标注 。 

当然 ,无 论 是 动态 查询 还 是 命名 查询 ,都 可 以 使 用 位 置 参 数 和 命名 参数 ,但 要 保证 一 个 
查询 中 不 能 混合 使 用 两 种 参数 。 

另外 ,queryl 和 query2 是 两 个 未 类 型 化 的 查询 对 象 ,而 query3 和 query4 是 两 个 类 型 
化 的 查询 对 象 。 通 过 query3 或 query4 查询 获得 的 单个 结果 或 集合 中 的 元 素 都 具有 Client 
类 型 。 
12.5.2 查询 API 

有 了 查询 对 象 , 接 下 来 就 可 以 通过 调用 查询 对 象 的 相关 方法 执行 它 所 包含 的 JPQL 语 
句 , 获 取 查 询 结 果 。 表 12-5 列 出 Query 对 象 的 一 些 常 用 方法 。TypedQuery 对 象 具有 的 方 
法 与 此 类 似 ,这 里 不 再 列 出 。 

表 12-5 Query 接口 的 常用 方法 


方 法 描 述 
Object getSingleResult() 检索 单一 实体 或 对 象 
List getResultList() 检索 实体 集合 


执行 一 个 更 新 或 删除 语句 


int executeUpdate() 
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续 表 


方 法 描 述 
Query setParameter(String name, Object value) 设置 命名 参数 的 值 
Query setParameter(int position, Object value) 设置 位 置 参数 的 值 
Query setMaxResults(int maxResult) 设置 要 检索 对 象 的 最 大 数量 


设置 第 一 个 结果 的 位 置 ( 从 0 开始 ) 


Query setFirstResult(int startPosition) 


1. 设置 查询 参数 

如 果 在 查询 对 象 时 指定 的 JPQL 语句 中 包含 输入 参数 ,那么 在 执行 查询 前 先 要 设置 相 
关 参 数 。setParameter(int，Object) 方 法 用 于 设置 位 置 参数 ,其 中 第 一 个 参数 指定 输入 参数 
的 编号 ,第 二 个 参数 指定 输入 参数 的 值 ;setParameter(String， Object) 方 法 用 于 设置 命名 参 
数 , 其 中 第 一 个 参数 指定 输入 参数 的 名 称 , 第 二 个 参数 指定 输入 参数 的 值 。 

下 面 代码 演示 如 何 设置 位 置 参数 和 命名 参数 。 


queryl.setParameter (1，" Zhaoyy") 
query2.setParameter("status", '1°'); // 用 户 状态 为 在 线 
query3 .setParameter (1，" Zhaoyy") 


query4.SsetParameter ("status", '1°'); 


这 些 设置 查询 参数 的 方法 都 返回 查询 实例 本 身 ,所 以 通常 可 以 省 略 返 回 值 。 

2. 查询 单一 实体 

查询 对 象 的 getSingleResult 方 法 用 于 查询 单一 实体 (或 对 象 ) ,此 时 应 确保 查询 的 结果 
有 一 个 实体 ` 且 仅 有 一 个 实体 。 如 果 不 存在 任何 实体 ,方法 抛 出 NoResultException 型 例 
外 。 如 果 存 在 多 个 实体 ,方法 抛 出 NonUniqueResultException 型 例外 。 

对 于 Query 对 象 ,该 方法 的 返回 类 型 是 Object, 可 以 强制 转换 成 确切 的 实体 类 型 。 对 
于 TypedQuery 对 象 ,该 方法 的 返回 类 型 在 创建 查询 对 象 时 就 已 确定 。 下 面 代码 查询 已 经 
指定 了 用 户 名 的 一 个 客户 实体 。 


Client clientl= (Client)queryl.getSingleResult (); 
Client client3=query3.getSingleResult (); 


3. 查询 实体 集合 

查询 对 象 的 getResultList 方法 用 于 查询 实体 (或 对 象 ) 集 合 ,方法 返回 一 个 List 表 。 对 
于 Query 对 象 ,该 方法 返回 的 List 表 的 元 素 类 型 是 未 知 的 ,而 对 于 TypedQuery 对 象 ,该 方 
法 返回 的 List 表 的 元 素 类 型 是 确定 的 。 

下 面 代码 查询 所 有 在 线 客户 实体 。 对 前 一 条 代码 ,编译 器 无 法 确定 返回 的 List 表 的 元 
素 类 型 是 否 为 Client, 所 以 会 出 现 编译 警告 信息 ,此 时 程序 员 应 确保 返回 的 List 表 的 元 素 类 
型 是 Client。 对 后 一 行 代 码 , 由 于 query4 是 类 型 化 的 查询 对 象 ,所 以 编译 器 可 以 确定 返回 
的 List 表 的 元 素 类 型 是 否 为 Client, 如 果 不 是 ,将 导致 编译 出 错 。 

List<Client> clients2=query2.getResultList () 7 


List<Client>clients4=query4.getResultList (); 
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如 果 不 存在 任何 查询 结果 ,方法 返回 null, 不 会 抛 出 例外 。 

4. 执行 更 新 或 删除 

执行 UPDATE 和 DELETE 语句 的 过 程 与 执行 SELECT 语句 的 类 似 ,首先 要 创建 相 
应 的 查询 对 象 , 然 后 再 调用 查询 对 象 的 executeUpdate 方法 。 方 法 返回 被 更 新 或 删除 的 实 
体 数 量 。 

下 面 代码 将 指定 客户 实体 的 email 属性 值 更 改 为 "zhaoyy@gmail. com”。 


EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPU"); 
EntityManager em=emf .createEntityManager (); 
try { 

em.getTransaction() .begin(); 

Query query=em.createQuery( 


"UPDATE Client c SET c.email='zhaoyy@gmail.com' WHERE c.username="'zhaoyy'"); 
query.executeUpdate (); 
em.getTransaction().commit (); 
} catch (PersistenceException e){} 
em.close(); 


emf.close(); 


通常 ,SELECT 语句 可 以 不 在 事务 内 执行 ,此 时 对 返回 结果 所 做 的 任何 修改 都 不 会 同 
步 至 数据 库 。 而 UPDATE 和 DELETE 语句 则 必须 在 事务 内 执行 ,否则 executeUpdate 方 
法 将 抛 出 TransactionRequiredException 例外 。 


12.6 论坛 一 重 写 业 务 方法 


本 节 继 续 11.5 节 介 绍 的 应 用 项 目 (luntan_final) ,为 论坛 应 用 重 写 所 有 的 业务 方法 ,使 
其 真正 从 已 经 创建 的 luntan 数据 库 中 访问 数据 。 这 里 ,不 再 创建 新 的 项 目 , 而 是 在 原来 应 
用 项 目 中 直接 进行 。 


12.6.1 为 论坛 应 用 定义 持久 性 单元 


要 在 应 用 中 通过 EntityManager 方法 或 查询 API 访 问 数据 库 , 首 先 需 要 定义 持久 性 单 
。 这 里 ,基于 应 用 项 目 中 原先 创建 的 JDBC 资源 jdbc/luntan( 数 据 源 ) ,定义 一 个 持久 性 单 
。 持 久 性 单元 的 属性 如 下 。 

。 持久 性 单元 名 称 : luntanPU 。 

。 持久 性 提供 器 : 缺 省 的 EclipseLink(JPA 2. 0)。 

。 使 用 Java 事务 API: 否 。 

。 表 生 成 策略 : 无 。 

定义 完 持久 性 单元 后 ,相关 的 定义 内 容 被 保存 在 persistence. xml 文件 中 。 文 件 位 于 项 
目 中 “配置 文件 ”节点 下 。 


12.6.2 更 改 命名 查询 


Hl dl 


通过 数据 库 自动 生成 的 Client、Topic 和 Reply 实体 类 中 ,都 会 包含 一 组 相关 的 命名 查 
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询 定义 。 根 据 处 理 需要 ,这 里 对 其 略 作 改动 。 
首先 修改 Topic 实体 类 中 的 Topic. findAll 命名 查询 定义 ,将 其 query 属性 值 由 : 


SELECT 七 FROM Topic 七 
SELECT t FROM Topic t ORDER BY t.lastreplytime DESC 


使 查询 返回 的 主题 按 其 最 后 回复 时 间 降 序 排序 。 
然后 为 Reply 实体 类 增加 一 个 命名 查询 ,查询 的 名 称 为 Reply. findByTid, 其 query 属 
性 值 为 


SELECT r FROM Reply r JOIN r.topic AS t WHERE t .id= :id ORDER BY r.replytime 


使 查询 返回 的 指定 主题 编号 的 所 有 回复 按 各 回复 的 回复 时 间 升 序 排序 。 
12.6.3 重 写 业 务 方法 


这 里 需要 对 model. ClientManager、model. TopicManager 和 model. ReplyManager 类 
中 的 所 有 方法 进行 重新 定义 。 

代码 清单 12-5 是 ClientManager 类 重 写 后 的 完整 代码 , 除 对 原 有 方法 进行 重新 定义 ,还 
添加 了 一 个 新 的 init() 方 法 。init 可 以 将 数据 库 中 所 有 客户 的 状态 设置 为 0( 不 在 线 ) 。 

代码 清单 12-6 是 TopicManager 类 重 写 后 的 完整 代码 。 代 码 清单 12-7 是 
ReplyManager 类 重 写 后 的 完整 代码 。 

代码 清单 12-5 ”model. ClientManager 类 


. Package model; 

. import entity.Client; 

. import javax.persistence.EntityManager; 

. import javax.persistence.EntityManagerFactory; 
. import javax.persistence.Persistence; 

. import javax.persistence.PersistenceException; 


. import javax.persistence.Query; 


ownamoumwwNb PP 


. Public class ClientManager { 

10. public Client findclientByName (String name){ // 根 据 用 户 名 获取 客户 

Ls EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPU"); 
12, EntityManager em=emf .createEntityManager (); 

13: Client client=em.find(Client.class,name); 

14. em.close (); 

15, emf.close(); 

16。 return client; 

要 这 二 LS 

18. public boolean insertClient (Client client){ // 插 入 一 个 客户 

LE EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPpU"); 


20 . EntityManager em=emf .createEntityManager () 7 
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33 . 


43. 


53 。 


boolean success=true; 

tr 
em.getTransaction() .begin(); 
em.persist(client); 


em.getTransaction() .commit (); 


catch (PersistenceException e){ 
success=false; 
} 
em.close (); 
emf.close(); 
return success; 
} 
public int getNumOfClient (){ // 获 得 所 有 用 户 数 
EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPU"); 
EntityManager em=emf .createEntityManager (); 
String sql="SELECT count (c) from Client c"; 
Query queryl=em.createQuery (sql); 
long n= (Long)queryl.getSingleResult (); 
em.close (); 
emf.close(); 
return (int)n; 
} 
public int getNumOfonline(){ // 获 得 状态 为 '1' 的 用 户 数 
EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPU"); 
EntityManager em=emf .createEntityManager (); 
String sql="SELECT count (c) from Client c WHERE c.status="'1'"; 
Query queryl=em.createQuery (sql); 
long n= (Long)queryl .getSingleResult (); 
em.close (); 
emf.close(); 
return (int)n; 
} 
public void logoff (Client client){ // 将 用 户 状 态 设 置 为 '0' 
EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPU"); 
EntityManager em=emf.createEntityManager (); 
client.setstatus('0'); 
try { 
em.getTransaction() .begin(); 
em.merge (client); 
em.getTransaction() .commit (); 
} catch (PersistenceException e){ 
} 
em.close (); 


emf.close(); 


66 . 
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68 . 
69 . 
70 . 
了、 
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74. 
75 
了 6。 
77. 
78, 
79s 
80 . 
81 . 
82. 
83. 
84. 
85 . 
86. 
87. 
88 . 
89. 
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public void login(Client client){ // 将 用 户 状态 设置 为 '1" 
EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPU"); 
EntityManager em=emf .createEntityManager (); 
client.setSstatus('1'); 
try 

em.getTransaction() .begin(); 
em.merge (client); 
em.getTransaction() .commit (); 
} catch (PersistenceException e){ 
} 
em.close (); 
emf.close(); 

} 

public void init (){ // 将 所 有 用 户 的 状态 设置 为 '0' 
EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPU"); 
EntityManager em=emf .createEntityManager (); 


String sql="UPDATE Client c SET c.status='0 


try{ 
em.getTransaction() .begin(); 
Query query=em.createQuery (sql); 
int n=query.executeUpdate(); 


em.getTransaction() .commit (); 


catch (PersistenceException e){ 
} 
em.close (); 


emf.close(); 


代码 清单 12-6 ”model. TopicManager 类 


. package model; 


. import entity.Reply; 


. import entity.Topic; 


. import java.util.List; 


. import javax.persistence.EntityManagerFactory; 


。 import javax.persistence.Persistence; 


1 
2 
3 
4 
5. import javax.persistence.EntityManager; 
6 
和 
8 


。 import javax.persistence.PersistenceException; 


9. import javax.persistence.Query; 


11. public class TopicManager { 


public int insertTopic (Topic topic){ // 插 入 一 个 主题 
EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPU"); 
EntityManager em=emf .createEntityManager (); 


boolean success=true; 
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Ey 
em.getTransaction() .begin(); 
em.persist (topic); 


em.getTransaction() .commit (); 


catch (PersistenceException e){ 
success=false; 
} 
em.close (); 
emf.close(); 
return topic.getId(); 
} 
public Topic getTopicById (int id){ // 根 据 id 返回 相应 的 主题 
EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPU"); 
EntityManager em=emf .createEntityManager (); 
Topic topic=em.find(Topic.class,id); 
return topic; 
} 
public List<Topic>getTopics(){ // 返 回 所 有 的 主题 
EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPpU"); 
EntityManager em=emf .createEntityManager (); 
Query query=em.createNamedQuery ("Topic.findAll1"); 
List<Topic>list=query.getResultList(); 
return list; 
} 
public void replyTopic (Topic topic,Reply reply){ // 主 题 新 增 一 个 回复 
EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPpU"); 
EntityManager em=emf .createEntityManager (); 
topic.setClientl (reply.getClient ()); 
topic.setLastreplytime (reply.getReplytime()); 
topic.setReplycount (topic.getReplycount ()+1); 
try { 
em.getTransaction() .begin(); 
em.merge (topic); 
em.getTransaction() .commit (); 
} catch (PersistenceException e){ 
} 
em.close (); 
emf.close(); 
} 
public void clickTopic (Topic topic){ // 主 题 的 点 击 数 增 1 
EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPU"); 
EntityManager em=emf .createEntityManager (); 
topic.setClickcount (topic.getClickcount ()+1); 
Sx 


em.getTransaction() .begin(); 


61. em.merge (topic); 


62。 em.getTransaction() .commit (); 
63. } catch (PersistenceException e){ 
64. } 

65. em.close (); 

66 . emf.close(); 

67. $$ 

68. } 


代码 清单 12-7 model. ReplyManager 类 


1. package model; 
2. import entity.Reply; 
3. import java.util.List; 
4. import javax.persistence.EntityManager; 
5. import javax.persistence.EntityManagerFactory; 
6. import javax.persistence.Persistence; 
7. import javax.persistence.PersistenceException; 
8. import javax.persistence.Query; 
Ys 
10. public class ReplyManager { 
11. public int insertReply (Reply reply){ // 插 入 一 个 回复 
3 EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanPU"); 
和 EntityManager em=emf .CreateEntityManager () 7 
14. boolean success=true; 
Ls try't 
16. em.getTransaction() .begin(); 
FE em.persist (reply); 
38” em.getTransaction() .commit (); 
19, } catch (PersistenceException e){ 
20. success=false; 
Z's } 
22。 em.close (); 
23. emf.close(); 
24. return reply.get1Id(); 
2 } 
26. public List<Reply>getReplys (int id)1{ // 根 据 主题 ia 返回 该 主题 所 有 的 回复 
EP EntityManagerFactory emf=Persistence.createEntityManagerFactory ("luntanpU"); 
28 . EntityManager em=emf .createEntityManager (); 
29, Query query=em.createNamedQuery ("Reply.findByTid"); 
30. query.setParameter ("id",id); 
as List<Reply>list=query.getResultList(); 
32. return list; 
33. } 
34. } 
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12.6.4 定义 和 注册 系统 事件 监听 器 


前 面 已 提 及 ,model. ClientManager 类 中 新 添加 了 一 个 init() 方 法 ,可 以 将 数据 库 中 所 
有 注册 客户 的 状态 设置 为 0( 不 在 线 )。 但 这 个 方法 不 会 无 缘 无 故 被 执行 ,为 了 使 该 方法 能 
在 应 用 部 署 和 运行 时 被 调用 ,需要 定义 和 注册 相应 的 系统 事件 监听 器 类 。 

首先 创建 一 个 名 为 listener 的 Java 包 , 然 后 在 包 中 定义 一 个 系统 事件 监听 器 类 ,可 以 监 
听 Application 对 象 引 发 的 事件 , 见 代 码 清 单 12-8。 

代码 清单 12-8 ”系统 事件 监听 器 类 (listener. LuntanSystemEventListener) 


10. 
11。 
12. 
13。 
14. 
15。 
16 . 
17. 


ownamumwwm 


. Package listener; 

。 import javax.faces .application.Application; 

. import javax.faces .event.SystemEvent; 

. import javax.faces .event .SystemEventListener; 


. import model .ClientManager; 


. Public class LuntanSystemEventListener implements SystemEventListenert{ 


@Override 

public void processEvent (SystemEvent event){ 
ClientManager cm=new ClientManager (); 
cm.init(); 

' 

@Override 

public boolean isListenerForSource (Object source){ 


return source instanceof Application; 


} 


然后 再 创建 Faces 配置 文件 (faces-config. xml) ,并 在 其 中 注册 上 述 监 听 器 类 ,使 其 可 以 
监听 PostConstructApplicationEvent 型 系统 事件 , 见 代 码 清单 12-9。 
代码 清单 12-9 注册 监听 器 类 


Ls 
碟 
3 
4 
5。 
6 
二 
8 


9. 


<application> 
<system-event-listener> 

<system-event-class> 
javax.faces.event.PostConstructApplicationEvent 

</system-event-class> 

<system-event-listener-class> 
listener.LuntanSystemEventListener 

</system-event-listener-class> 


</system-event-listener> 


10. </application> 


至 此 ,对 应 用 项 目 luntan_final 业务 方法 的 重 写 工作 已 全 部 结束 。 原 来 的 模拟 业务 数 
据 的 mode. DataBase 类 已 没有 存在 的 意义 了 ,可 以 从 项 目 中 删除 掉 。 
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3. 
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12.7 小 结 


要 在 应 用 程序 中 通过 操作 实体 实现 数据 库 访问 ,首先 需要 定义 持久 性 单元 。 持 久 性 
单元 定义 在 persistence. xml 文件 中 ,该 文件 存放 在 META-INF 目录 下 。 
实体 的 状态 包括 四 种 : 新 的 实体 实例 、 受 管理 的 实体 实例 分离 的 实体 实例 、 删 除 的 
实体 实例 。 

通过 EntityManager API, 可 以 对 实体 进行 各 种 操作 ,包括 : 查找 实体 实例 、 持 久 实 
体 实 例 、 合 并 实体 实例 .删除 实体 实例 分 离 实体 实例 、 刷 新 数据 库 、 刷 新 实体 实例 、 
清空 持久 性 上 下 文 等 。 

涉及 实体 实例 新 建 、 更 新 和 删除 等 的 操作 一 般 应 该 在 事务 内 执行 。 本 地 资源 型 事务 
的 控制 在 应 用 程序 编程 接口 EntityTransaction 中 定义 。 

Java 持久 性 查询 语言 (JPQL) 用 于 定义 基于 实体 的 查询 ,以 及 批量 更 新 和 删除 操作 。 
JPQL 语句 包括 SELECT 语句 .UPDATE 语句 和 DELETE 语句 。 

JPQL 语句 的 执行 需要 持久 性 提供 器 支持 ,并 通过 查询 API 实现 。 查 询 对 象 可 以 通 
过 调用 EntityManager 的 createQuery 等 方法 获得 。 

定义 JPQL 语句 的 方式 有 两 种 : 一 是 所 谓 的 动态 查询 , 即 在 程序 代码 中 创建 JPQL 
语句 字符 串 ; 二 是 所 谓 静 态 查 询 或 命名 查询 ,是 指 用 @NamedQuery 标注 定义 JPQL 
语句 并 对 其 命名 。 


习 题 12 


. 什么 是 持久 性 单元 ”如 何 定义 一 个 持久 性 单元 ”持久 性 单元 的 定义 保存 在 哪个 文 


. 实体 有 哪 几 种 状态 ? 简 述 各 状态 的 特点 。 


简 述 实体 管理 器 中 有 关 实 体操 作 的 几 种 主要 方法 。 
何谓 JPQL? JPQL 包括 哪些 语句 ?如 何 执行 JPQL 语句 ? 
修改 应 用 项 目 sh6_lookandbuy( 第 6 章 习 题 6) ,使 其 从 数据 库 bookstore( 第 11 章 习 


题 4) 中 而 非 model. DataBase 类 中 访问 图 书 数据 : 

(1) 在 项 目 中 创建 bookstore 数据 库 的 一 个 JDBC 连接 池 ,然后 再 基于 该 连接 池 创 建 一 
个 JDBC 资源 。 

(2) 基于 上 述 JDBC 资源 ,创建 对 应 于 数据 库 表 BOOK 的 实体 类 Book ,并 替换 项 目 中 
原先 的 Java 类 entity. Book。 

(3) 基于 上 述 JDBC 资源 ,为 项 目 定义 一 个 持久 性 单元 。 

(4) 修改 model. BookManager 类 中 的 相关 方法 .使 其 通过 访问 数据 库 完成 相应 的 业务 
处 理 功 能 。 
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